This version is out of date, covering development from v9.0.0 to v9.3.0. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v9 Icon

Sort


Attribute Data Type: 

Attribute Default Value: 

Attribute Group: 

Attribute Purpose: 

Attribute Inherited from Preferences?   

Attribute UI-configurable? 

Attribute Read-Only? 

Attribute Intrinsic? 

Attribute First Added: 

Attribute Altered: 

 string   [other string-type attributes]

 (not set - empty string)

 Sorting   [other Sorting Group attributes]

 Sort configuration

 No

 Yes

 No   [other read-only attributes]

 No   [other intrinsic attributes]

 Baseline

 


Specifies the primary sorting order for notes within containers, agents and smart adornments.

The order is based on the name of an existing system or user attribute. The name is cited without a $-prefix as this attribute stores the desired attribute's name, not its value:

CORRECT: $Sort = "SomeAttribute" (case-sensitive)

FAIL: $Sort = $SomeAttribute

In default sorting A-Z precedes a-z, thus the sort order Aardvark, Boy, aardvark [sic], though this can be altered by $SortAlso which offers three choices of sort logic.

A secondary sort is also allowed, such as where two notes have equal values under the main sort criterion. The secondary sort is set via $SortAlso.

On the Action Inspector's Sort sub-tab, the list of available choices is shown in a $Sort pop-up menu in the upper set of controls

If unsure of allowed attributes on which to sort, the best place to set a sort is via the note's naming panel (Enter key). If exposed via $KeyAttributes, the value pop-up will only show values already sorted on within the document.

To reverse the sort order based on the given attribute, use $SortBackward.