Dialog Box Controls
This section lists the various types of controls you might want to include in a dialog box, with requirements and recommendations on their use.
Cosmetic Dialog Controls
Label
- Specify natural-length struts for width and height
Box Control
Line Control
Icon
- Specify natural-length struts for width and height
Simple Dialog Controls
Checkbox
- Can be a simple checkbox (any number of controls in a group can be selected)
- Can be a radio button group (only one control in the group can be selected)
- Action procedure called when toggled
- A radio button group can be exclusive dialog-wide. You can also specify multiple exclusive radio button groups in a single dialog.
- If you design multiple exclusive radio button groups in a single dialog box, use separators (such as the line control) between the radio button groups. This signals to the user that each group is separate and exclusive only within itself.
- Specify natural-length struts for width and height
Button
- Action procedure called when clicked
- Can use an icon image instead of a title
- Specify natural-length struts for width and height
Slider
- Action procedure called when released
- Specify natural-length struts for width if vertical and natural-length struts for height if horizontal
Spinner
- Action procedure called when arrow clicked or new value entered
- Specify natural-length struts for width and height
Pop-Up Menu
- Action procedure called when menu control selected
- To add or edit menu controls, select the Dialog Item tab in the Popup Menu Editor, check the Menu check box, and click on the Set Menu... button.
- Specify natural-length strut for height
- Specify natural-length strut for width, unless a menu item can be arbitrarily long. (The natural width of a pop-up menu is the maximum width of all menu items.)
Combo Box
- Action procedure called when menu control selected or new value entered
- To add or edit menu controls, select the Galaxy Popdown Combo tab in the Combo Box Editor and enter menu controls in the pane.
- Specify natural-length strut for height
- Specify natural-length strut for width, unless a combo value can be arbitrarily long. (The natural width of a combo box is the maximum width of all values in the box.)
Edit Field
- Action procedure called when new value entered
- Specify One Line set, but Wrap and both Scrollbar attributes not set
- Specify natural-length strut for height
- Should not have natural-length strut for width
Extended Dialog Controls
Edit Area
- Has no action procedure
- Should have One Line not set and should have a Vertical Scrollbar
- Should either have Wrap set or have a Horizontal Scrollbar
- Use fixed-length struts for width and height
Treeview
- Has no action procedure, but does have init, expand, left click, and right click procedures
- Should have a Vertical Scrollbar; usually has a Horizontal Scrollbar
- Use fixed-length struts for width and height
Table
- Has no action procedure, but does have display, store, and left-click procedures
- Should have a Vertical Scrollbar; can also have a Horizontal Scrollbar