Error getting tags :
error 404Error getting tags :
error 404 openBackground | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
openBackground
Basics
Expander triangle
Type
Message
Syntax
openBackground backgroundID
Introduced
1.0
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Sent to the current card right after you go from a card that does not have the group to a card that does.
Examples

on openBackground theBackgroundID -- checkmark the current background
put lineOffset(the short name of group ID theBackgroundID, \
button "Forms") into thisBgLineNumber -- button "Forms" is a menu
put "!c" before line thisBgLineNumber of button "Forms"
end openBackground

Additional Comments
Expander triangle

Handle the openBackground message to change a group's objects, or perform other updates, when a card with the group on it is visited.

Parameters:

The backgroundID is the ID number of the background being opened.

Comments:

The openBackground message is sent to the card, then (if the card does not trap the message) along the message path to each group on the card. This means that if there is more than one group on the card, the openBackground message is sent to each one.

The openBackground message is sent after the destination card is visible. To make changes that take effect before the card becomes visible on the screen, use the preOpenBackground message instead.

The actual navigation is not triggered by the openBackground message, so trapping the message and not allowing it to pass does not prevent the card with the group from opening.

User Comments
Expander triangle
User thumbnail
Devin Asay
StarStarStarStarStar
Dec 14, 2010
It should be clarified that this message is only sent to groups whose backgroundBehavior property is set to true; i.e., it is only sent to true background groups, not every group as this entry implies.