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

OnJoin


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: 

 action   [other action-type attributes]

 (not set - empty string)

 Composites   [other Composites Group attributes]

 Composite configuration

 No

 No

 No   [other read-only attributes]

 No   [other intrinsic attributes]

 Baseline

 


An action performed when new composite members first touch existing members.

Notes may have an $OnJoin action. When a note that was not previously a member of a composite is dragged to touch a note with an $OnJoin action, the $OnJoin action is performed on the dragged note. If a note touches more than one note in the composite, each $OnJoin action is performed in turn.

In the context of an $OnJoin action, designator 'this' references the note joining the composite whilst 'that' references the note within composite to which it is now adjacent.