- 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 dragDropSpec property specifies the drag and drop
information for the part.
You can tear-off the dragDropSpec property to access its
properties and events. If the part has a Drag/Drop tab in
its Settings window, the drag and drop properties and events will be added to
the part once you have selected either Allow drag or Allow
drop in the part's Settings window.
The dragDropSpec property has the following properties for
specifying drag and drop information:
- canBeDragSource (Boolean)
- Specifies whether the part can be the source of a drag operation.
The source is where the drag is started.
- canBeDragTarget (Boolean)
- Specifies whether the part can be the target of a drag operation.
The target is the part under the cursor during the drag.
- defaultDragOperations (OrderedCollection)
- Specifies the following default drag operations for the array of any or
all elements, with the first elements having the highest priority:
- XmMOVE
- XmCOPY
- XmLINK
- XmILLEGAL
- defaultDropOperations (OrderedCollection)
- Specifies the following default drop operations for the array of any or
all elements, with the first elements having the highest priority:
- XmMOVE
- XmCOPY
- XmLINK
- XmILLEGAL
- dropAcceptableClassList (OrderedCollection)
- Specifies a list of classes where instances can be added to the part for a
drop operation.
The dragDropSpec property has the following drag and drop
events, which all pass a callData parameter from which it gets information
about the source, target, operation, and emphasis:
- dragChanged
- Signals to the source that the target or operation of the drag session has
changed.
- dragCompleteRequested
- Signals to the source that the drag session has completed and requests
that the source perform any necessary actions for the operation.
- dragLeave
- Signals to the target that the mouse pointer has left its bounding box
during a drag session. You may want to use this for changing the target
emphasis.
- dragOver
- Signals to the target that the mouse pointer is moving over it during a
drag session. The target must fill in the vote field of the callData
parameter with the operation acceptable with regard to the source
items. See the defaultDropOperations attribute for
acceptable vote values.
- dragSourceCancelled
- Signals to the source that the drag operation was cancelled.
- dragStartRequested
- Signals to the source that the drag session has started. The source
items, images and offsets must be filled in the respective fields of the
callData parameter.
- dragTargetCancelled
- Signals to the target that the drag operation was cancelled.
- dropped
- Signals to the target that the dragged items have been dropped and
requests that the target perform any actions necessary for the drop
operation.
- enabled
- 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, VisualAge 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.