Action Statement
Create a new object, action bar item, or plate during runtime.
For Objects and Items:
add {ITEM_DEF|OBJECT_DEF}
For Action Bar Templates:
add action bar AB_NAME is
[PULLDOWN_DEF_OR_REF] ...
[BUTTON_DEF_OR_REF] ...
end action bar
ITEM_DEF
The definition for a pulldown, button, choice, or separator.
OBJECT_DEF
The definition for an object.
AB_NAME
The identifier for an action bar template.
PULLDOWN_DEF_OR_REF
The definition for, or reference to, a pulldown.
BUTTON_DEF_OR_REF
The definition for, or reference to, a button.
Description
The new object is created when the add statement is executed.
When using this statement, be careful to ensure that the identifier specified is unique. To minimize the risk of duplicating identifiers, specify a variable whose value is the identifier, rather than specifying an explicit name, in the add statement.
You can use an item reference to reference any item that you have defined outside of an action bar template.
Only regions that are children of the desktop can have action bars.
Examples
response to GoBack
add key NewChoice_KEY at position 10 10
solid red box 100 20
move to 50 10
text "ABANDON SCREEN"
response to OpenWriter
add textual region Blackboard_TR
window size 10 columns 10 lines
at position 10 200 in GraphArea
response to NewMessage
add action bar Mail_Window_AB is
pulldown Exit_Choices text "E~xit"
choice Exit text "~Exit"
choice Resume text "~Resume Mail"
end pulldown
end action bar
add color 26 graphical region Mail_Window_GR
size 263 160
at position 60 80
in desktop
color 27 foreground
size border
title bar "Mail"
system menu
horizontal scroll bar scroll by 6
vertical scroll bar scroll by 16
no scale
action bar Mail_Window_AB
# The following code dynamically builds an action bar
# with pulldowns and choices.
#
string ActionBar_SV
PullDown_SV
PullDownText_SV
Choice_SV
ChoiceText_SV
response to start
copy "Attribute_AB" to ActionBar_SV
copy "Material_PD" to PullDown_SV
copy "Material <~S>" to PullDownText_SV
copy "Glass_MC" to Choice_SV
copy "10 Glass" to ChoiceText_SV #Continued
# Dynamically create an action bar.
add action bar ActionBar_SV is
end action bar
# Dynamically create a text region, with the newly created
# action bar.
add color 26 primary graphical region Text_Window_CR
size 200 200
at 100 100
in desktop
title bar "Dynamic Action Bars"
system menu
action bar ActionBar_SV
# Dynamically create a pulldown.
add pulldown PullDown_SV text PullDownText_SV
end pulldown
# Dynamically add the pulldown to an action bar.
add item PullDown_SV to action bar in Text_Window_CR
# Dynamically create a choice.
add choice Choice_SV text ChoiceText_SV
# Dynamically add the choice to a pulldown.
add item Choice_SV to pulldown PullDown_SV in Text_Window_CR
See Also
Object definition statements
