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

DisplayExpressionDisabled


Attribute Data Type: 

Attribute Default Value: 

Attribute Group: 

Attribute Purpose: 

Attribute Inherited from Preferences?   

Attribute Read-Only? 

Attribute Intrinsic? 

Attribute First Added: 

Attribute Altered: 

 boolean   [other boolean-type attributes]

 false

 General   [other General Group attributes]

 Action code

 No

 No

 Yes

 5.8.0

 


Allows the $DisplayExpression for a specific note to be disabled. It is intrinsic and thus not inherited.

A primary use is suppressing code from be run in prototypes.

$DisplayExpressionDisabled is convenient when a display expression is shared by all the children of a prototype, but it is not desirable that it be applied to the prototype itself. Thus it can be useful to suppress $DisplayExpression activation in prototypes. Previously, it was necessary include an 'if($Prototype)' test which was cumbersome and meant every inheriting note had to run the additional if test adding load to the action code cycle. That workaround can be discarded and the attribute set to false in the Prototype. Because, atypically, this attribute isn't inherited from a prototype, the prototype's setting doesn't affect the Display Expression in notes using the prototype.

For example, the intention may be for books to be displayed with their price:

DisplayExpression: $Name+" $"+$Price 

but the prototype for books, "Book Prototype" could inhibit this $DisplayExpression to display its name without a meaningless price tag.

A similar control is supplied for rules: $RuleDisabled.


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


A Tinderbox Reference File : Attributes : Attribute Groups within Tinderbox : Attributes which are intrinsic : DisplayExpressionDisabled