Maptitude GISDK Help |
A checkbox item is a labeled box that a user can check or uncheck, or an icon displayed as a button that is depressed (checked) or raised (unchecked). The format of a checkbox item definition is:
Checkbox {"item name"} hpos, vpos {, width {, height}} {options} {do
<statements go here>
endItem}
If the do ... endItem section of the checkbox definition is included, the statements are executed whenever the user checks or unchecks the box.
Checkbox Options |
Description |
Key: hotkey |
The key sequence the user can press to toggle the checkbox instead of using the mouse. The hotkey has the format alt_character, where character must be a letter or number. For example, Key: alt_A indicates that holding the Alt key and pressing A activates the item. The specified key is underlined in the item's text. A hotkey only works if the key in question is part of the item's text and is case insensitive. |
Disabled |
The checkbox is initially disabled. |
Hidden |
The checkbox is initially hidden. |
Help: help_specs |
Help information displayed in a popup window and the status bar. Help strings can be string expressions. |
Icon: icon |
A checkbox can be a button that is raised or depressed. icon specifies the location of the button, and can be a string constant or a string expression. If the string specifying the icon is of the format filename.bmp|i, where i is an integer, the bitmap file is assumed to contain a row of square icons, with no gaps between the icons, and the ith icon in the row will be displayed. The graphic of the icon should not contain borders, as any outlining of the button is now handled automatically. |
Prompt: expression |
The text next to the checkbox. If omitted, the name of the checkbox is used. |
Variable: variable |
A variable to receive the state of the checkbox. If the user clicks to uncheck the box, the variable is set to zero. If the user checks the box, the variable is set to one. The initial value of this variable affects how the checkbox displays initially: If the variable is non-zero, the checkbox is checked, if it is zero or null, the checkbox is unchecked. |
For example:
Checkbox 10, 6 prompt: "Use actual point sizes" variable: pt_sz
©2025 Caliper Corporation | www.caliper.com |