This version is out of date, covering development from v7.0.0 to v7.5.6. 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 7 Icon

Navigating map views

Why do some icons look different?

Although the actual colour of each note's icon in a Map View may vary by the colour-related attributes you set, it will always appear in one of two basic styles:

Also

What are the blocks of colour in the grey area of the container notes?

These represent child notes inside the container, i.e. you are seeing down one level into the the child notes' map. By default the child notes in the viewport will show their titles as well. If the sub-map in the viewport does not have a grey background that is because its $MapBackgroundColor has been set to a non-default value. Badges and Shapes are also shown, as indeed are most of the map visualisation attributes.

Why is the grey area at the top of some containers and not the bottom?

These indicate the container is an agent. To clarify, in a Map view a normal note container has its title area at the top of the note whilst an agent container has its title area at the bottom of the note.

How do I navigate down / open a container / drill down a level?

The three preceding questions are effectively all the same. To drill down into any container, you double-click the viewport area of the note and you then navigate down / open / drill down — whichever euphemism you prefer. Should you mistakenly click the top (title) part of the note icon you will open the note for editing. If the latter happens by mistake, don't worry, simply close the note and make sure you double-click the lower portion of the note. This method works for both normal (note) and agent containers. An alternate method is to select container and press the Down Arrow key.

How do I navigate up a level?

To shift the map view's focus to the to the parent map ('drill up'), click the 'up arrow' icon bottom left of the view window. Alternatively, use the Views menu -> Expand View (or its shortcut), or just use the Up Arrow key.

How do I quickly get back up to whole-document outline focus?

Use Note menu -> Unhoist (there is no shortcut).

How can I tell if my current outline view has whole-document focus?

If the 'up-arrow' icon bottom left of the view window is greyed out, the outline is showing the highest left of focus, i.e. the whole document. Still unsure? Use the 'Unhoist' method mentioned above as the resultant scope is always for the whole document.

Can I interact with the child map in the viewport?

Yes you may thought it often helps to drag the parent containers icon is bit larger to increase the size of the viewport. You can do two things:

Can containers show note body copy text, display tabular info, etc., like non-containers?

Yes. For containers, note or agent, the attribute $TitleHeight controls how much of the map icon is devoted to the viewport. The only difference between note and agent containers in this regard is that body text or $TableHeading/$TableExpression information is always displayed beneath the icon title - which makes sense when you see it on screen - regardless of the relative position of the viewport. To set $TitleHeight manually in map view, simple drag the bottom (note container) or top (agent) of the solid colour area of the icon and drag it up/down to alter the relative allocation of space to title/text vs. viewport. To provide more space overall drag the corner of the container's note icon; as the icon grows/shrinks in size, the title/viewport allocation scales accordingly allowing the $TitleHeight to then be re-adjusted. Being an attribute, $TitleHeight can also be set via action code.