This version is out of date, covering development as far as v4.2.5. It is maintained here only for inbound reference links from elsewhere.
Jump to the current version of aTbRef.
|A Tinderbox Reference File : Objects & Concepts : Adornments|
An adornment is seen only in Map views and is used to provide a means of adding visual elements to the background of the Map view. Created via the Create Adornment dialog accessible only from the Map pop-up menu.
Although adornments are not listed in the views like Outline, these objects do have attributes. To control details like the border width, select an adornment and either use the [Cmd]+[Opt]+[I] shortcut or select Get Info from its pop-up menu to open the Info dialog. Most attributes are irrelevant for an adornment except those in the Map section.
Note that adornments do get counted in the outline order numbering, even if not visible there; the are counted as the last sibling(s) child(ren) of the note on whose Map view they appear. This ensures the adornment always sit behind any notes on the map. Using 'send to back' on a note in Map view will not place it behind any adornments. However, if the map has more than one adornment it is still possible to use the sent forward/back commands to re-arranze the z-order of adornments alone.
As adornments (can) act as a form of container, they have support for Actions - just like agents and container notes. As with a container note, the action string is stored in the OnAdd attribute, and is triggered when a note or agent is dragged onto the adornment. A note being 'on' an adornment occurs if all or part of the note lies within the adornment's boundaries.
As from v2.5.0, adornments now show their locked/sticky states with lock and push-pin icons. In v3.0.0 the push-pin and lock icons are packaged separately in the application allowing custom icons to be added.
From v4.0.0, a prototype can hold adornments - at its sub (container) level.
Adornments are discussed further under discussion of the Map view.
|Up: Objects & Concepts|
|Previous: Macros||Next: Windows & Views|
Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]