This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

KeyAttributes


Attribute Data Type: 

Attribute Default Value: 

Attribute Group: 

Attribute Purpose: 

Attribute Inherited from Preferences?   

Attribute Read-Only? 

Attribute Intrinsic? 

Attribute First Added: 

Attribute Altered: 

 set   [other set-type attributes]

 (not set - empty string)

 TextFormat   [other TextFormat Group attributes]

 Note key attributes

 No

 No

 No

 Already in v5.0.0

 


A Set of attribute names to be displayed at the top of the current note's text page (or text pane in Explorer view).

The exposed attributes can be edited in situ; at its right, each non read-only attribute shown has a small black disclosure triangle. Clicking the latter opens a pop-up menu listing all the currently used values for that attribute. You can either select one of these or add your own value (which is subsequently shown in the pop-up list).

NOTE: Displayed value boxes only support the MacRoman character set - Unicode data may not display properly although underlying Unicode data if not affect as long as the box is not edited.

The desired 'key' attributes are displayed in the current note's text window from top to bottom in the order listed in the KeyAttributes string. The string may be set via:

Note that in the case of action code (#1 above) the set string must be quoted and no $-prefixes are used with the attribute names.

Thus a set value like Width;Height;OnAdd would cause system attribute 'Width' to be listed first, then 'Height', etc. Note that if selected for display manually, a note's displayed attributes as listed in alphabetical order.

If you change the value list, of the order of items in the list, you will need to refresh the note window — most easily done by clicking another Tinderbox window and then clicking back on the note (there is no 'refresh view' menu option).

$KeyAttributes can also be added by dragging them from the User or System panes of the Attributes dialog onto a note's text window.

By default, $KeyAttributes are displayed in alphabetical order, but they can be set in a custom order using an custom semicolon delimited list for this attributes values; additions/deletions to such custom orders won't reset the list to alphabetical.

The names of key attributes in the text window are drawn in $NameFont (defaulting to Preferences:Maps:Note Label Font).

Up to 8191 characters are allowed for the set's value string(s), giving plenty of room for complex pattern matching strings.

Dragging an item out of the key attribute table in note Text windows, deletes that item from $KeyAttributes.


Possible relevant notes (via "Similar Notes" feature):


A Tinderbox Reference File : Attributes : Attribute Groups within Tinderbox : TextFormat Attributes : KeyAttributes