Workbench User Guide : Creating and Using Basic Fields : Scalar Fields : Create a Pop-up Button
 
Share this page          
Create a Pop-up Button
A pop-up button is a button control that has an option menu associated with it. Like the independent control button, you must define the pop-up button's option menu, creating all the menu items and writing scripts for them. Unlike a control button, which always looks like any other control button and never has text, a pop-up button may have either text or an image.
To create a pop-up button
1. Open your frame in the Frame Editor (see Open an Existing Frame).
2. Select the Pop-up Button icon on the field palette.
3. Position and size the pop-up button on the form.
4. Leave the field selected on the form.
5. Set the properties for the pop-up button, including BitmapLabel, PopupAlignment, and TextLabel in the Property Inspector.
Note:  For complete descriptions of each field property, see Pop-up Button Properties and Common Field Properties.
6. Click Edit, Option Menu.
The Option Menu Editor appears.
7. Define the option menu to be associated with the pop-up button.
For more information about creating menus and menu items, see Creating and Modifying Menus.
8. Use the Property Inspector to set the properties for each menu item, including the ValueList property, where you specify the choices for a menu list using the Value List dialog.
For more information about defining choice lists, see Add and Delete List Field Items.
9. Click File, Close in the Option Menu Editor when you are done editing the option menu.
Pop-up Button Properties
All the properties for pop-up buttons are described under Common Field Properties, with the exception of the following properties that are specific to the pop-up button field type:
BitmapLabel
Specifies a file containing the image to be displayed as the button label. When you click this button, a standard File Selection dialog appears. Enter the directory path of the new image you want to use.
IsAutoSized
Specifies whether the button field is forced to ignore its Height and Width property values and resize itself to fit the current text label (in the current font). If the text is changed, the button is resized accordingly. Possible values are:
TRUE
Specifies that the field is auto-sized
FALSE
Specifies that the field uses its Height and Width property values
PopupAlignment
Specifies how the pop-up button's corresponding menu will be aligned relative to the button itself. Valid options are:
ALIGN_BOTTOM
ALIGN_CENTER
ALIGN_LEFT
ALIGN_RIGHT
ALIGN_TOP
Default: ALIGN_BOTTOM
TextAlignment
Specifies the alignment for a button's text label. Valid options are:
ALIGN_LEFT
ALIGN_RIGHT
ALIGN_TOP
ALIGN_BOTTOM
ALIGN_CENTER
Default: ALIGN_CENTER