Advanced properties for Toggle Box
- Last Updated: March 12, 2026
- 1 minute read
- OpenEdge
- Version 13.0
- Documentation
The Advanced Properties dialog allows you to set advanced properties for the selected toggle box.
This dialog includes the following options:
| Initial Value | Enter an initial value for the toggle box. The GUI Designer writes this value to the DEFINE VARIABLE statement for the toggle box. |
| Help | Enter a help string for the toggle box. The GUI Designer displays the help string in the run-time window status bar whenever the toggle box has input focus. |
| Private Data | Enter any private data about the toggle box. Private data is an annotation containing any character data that you can attach to an object. This annotation is only informational and not used by the code. The GUI Designer reads and writes private data as comments in the Run-time Attribute and AppBuilder Settings section of procedure files. |
| Characters | Select this option to write toggle box size and position in character units. The GUI Designer writes the values entered in Column, Row, Width, and Height on the TOGGLE-BOX Property Sheet in character units using the Size and At phrases in the DEFINE VARIABLE and DEFINE FRAME statements. |
| Pixels | Select this option to write toggle box size and position in pixel units. The GUI Designer writes the values entered in X, Y, Width Pixels, and Height Pixels in pixel units using the Size and At phrases in the DEFINE VARIABLE and DEFINE FRAME statements. |
| Custom Lists | Select this option to add the toggle box name to
the selected custom list. For example, select the {&List-1}
check box to add the toggle box name to custom list &List-2. One of six user-defined, alphabetical lists of space-delimited object names represented by the preprocessor names (&List-1, &List-2, &List-3,&List-4, &List-5, &List-6). You can use custom lists in ABL code whenever you need to represent object names, as in the following example:
The GUI Designer adds an object name to a custom list whenever you activate one of the list toggles on the object's Advanced Property Sheet. Objects that are cut or deleted from a procedure file are automatically removed from the appropriate list. |
| X | Enter a value in pixels from the window left edge
where you want to place the toggle box upper left or right corner.
Note: Depends upon the position
setting. For example, if Left-Align is chosen, the value in X
refers to the toggle box upper left corner.
|
| Y | Enter a value in pixels from the window top edge
where you want to place the toggle box upper left or right
corner. Note: Depends upon the
position setting. For example, if Left-Align is chosen, the
value in Y refers to the toggle box upper left corner.
|
| Width Pixels | Enter a value for the number of pixel units wide to make the toggle box. |
| Height Pixels | Enter a value for the number of pixel units high to make the toggle box. |
| Left-Align | Select this option to position the toggle box left edge along the column / X position specified. |
| Right-Align | Select this option to position the toggle box right edge along the column / X position specified. |
| Advanced Settings | This topic allows you to select advanced run-time attributes and other ABL related options for the selected toggle box. |
| Current Layout | Displays the current layout used to display the toggle box. |
| Sync With Master | Displays the Sync with Master dialog dialog which allows you to overwrite
the current layout with the toggle box default properties. Note: The Sync
With Master option is enabled if you have
defined a master layout.
|
For more information, see Property Sheet dialogs.