Toggle Button properties
The Toggle Button part has the following properties:
alignment
The alignment property specifies that the text, icon, or bitmap can be aligned either left, right, or centered. On some platforms, the alignment for push buttons, toggle buttons, and cascade buttons cannot be set and is ignored. The possible values are as follows:
XmALIGNMENTBEGINNING
Left alignment
XmALIGNMENTEND
Right alignment
XmALIGNMENTCENTER
Center alignment
backgroundColor
The backgroundColor property is the name of the RGB color for the background of the part.
borderWidth
The borderWidth property is the width of the border, specified in pixels, that surrounds the part on all four sides. A width of zero means that a border does not show.
On some platforms, the border width is limited to 1 pixel and any nonzero value is set to 1.
converter
The converter property is an object that manages the conversion of other objects to and from their display format for certain visual parts, such as a Text part.
disabledGraphicsDescriptor
The disabledGraphicsDescriptor property is an icon, bitmap, or image used to indicate that the part is disabled. The labelType property must be an icon, bitmap, or image or the disabledGraphicsDescriptor property is ignored.
dragDropSpec (AbtDragDropSpec)
The enabled property specifies whether or not the part is available for selection. If true, the part's contents are available for selection.
fontName
The fontName property is the name of the font to use for the text displayed in the part.
foregroundColor
The foregroundColor property is the name of the RGB color for the foreground of the part.
framingSpec
The framingSpec property represents the values specified for the edge specifications of the part. The edge specifications determine the width, height, and position of the part.
graphicsDescriptor
The graphicsDescriptor property is an icon, bitmap, or image that is used instead of text for the label. The labelType property must be XmPIXMAP or the graphicsDescriptor property is ignored.
helpFile
The helpFile property is the name of the help file associated with the part.
helpKeysId
The helpKeysId property is the ID of the keys help associated with the part. The ID can be a string or an integer value.
The ID must exist in the help file associated with the part.
helpTitle
The helpTitle property is the title of the help window associated with the part.
helpTopicId
The helpTopicId property is the ID of the help topic associated with the part. The ID can be a string or an integer value.
The ID must exist in the help file associated with the part.
indicatorOn
The indicatorOn property specifies that the check box is drawn to the left of the check box text, icon, or bitmap; otherwise space is not allocated for the indicator and it is not displayed.
labelMarginBottom
The labelMarginBottom property is the amount of space between the label and the bottom margin.
labelMarginHeight
The labelMarginHeight property is the amount of space between the label and the bottom edge of the top shadow and the top edge of the bottom shadow.
labelMarginLeft
The labelMarginLeft property is the amount of space between the label and the left margin.
labelMarginRight
The labelMarginRight property is the amount of space between the right margin and the label of the part.
labelMarginTop
The labelMarginTop property is the amount of space between the label and the top margin.
labelMarginWidth
The labelMarginWidth property is the amount of blank space between the label and the right edge of the left shadow and the left edge of the right shadow.
labelType
The labelType property specifies the type of label you want. The possible values are as follows:
XmSTRING
The string defined by labelString is displayed.
XmPIXMAP
The graphic defined by graphicsDescriptor is displayed.
mnemonic
The mnemonic property is a character that the user can type to select an item.
A mnemonic character is displayed with an underscore (_) and is usually used for buttons belonging to menus.
object
The object property is the data that the part represents. If the part represents non-string data, use this property; otherwise use the labelString or string property.
For example, you can use the object property with a converter to display the label of a button.
partName
The partName property specifies the name you want to use to describe the part. For nonvisual parts, this text appears under the icon for the part on the free-form surface.
The name of the part can consist of alphanumeric characters, and must be different from those of all other parts on the layout surface.
If you do not specify a part name, VA Smalltalk generates a unique name based on the class name of the part.
recomputeSize
The recomputeSize property specifies whether the part always attempts to exactly fit in the space provided a new text string, icon, or bitmap. If the recomputeSize property is set to true, when the label changes, the part changes size to include the new label.
selection
The selection property specifies the selection state of the part.
tabGroup
The tabGroup property specifies whether or not the part is included as a tab stop so users can use the Tab and Backtab keys to access the part.
traversalOn
The traversalOn property specifies whether users can access the part using the cursor movement keys. If the part is specified as a tab stop by using the tabGroup property, users also can use the Tab and Backtab keys to access the part.