- buttonType
- The buttonType property specifies what type of button the part
represents. The following choices are available:
- XmCHECKBUTTON
- Creates a button that represents a boolean value. Selecting the
button toggles the set value.
- XmPUSHBUTTON
- Creates a tool bar button that behaves like a normal push button.
- XmRADIOBUTTON
- Creates a button that indicates a selected state. A radio button
group is a set of tool bar buttons with buttonType set to
XmRADIOBUTTON that are laid out contiguously on the tool
bar. Selecting a particular radio button toggles the set value.
To toggle the value back, the user selects another button in the Radio button
group.
Note: | Changing the buttonType has no effect on the appearance of the
Tool Bar button. It only changes the runtime behavior.
|
- 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.
- 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.
- labelString
- The labelString property is the label of the part in string
form.
For example, to dynamically display the string format of a number value, do
the following:
- Define the label with the Number data type.
- Assign a value to the label.
- Connect the labelString attribute to this label.
- 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.
- set
- The set property indicates whether the button is in its
selected state (grayed). If this property is set to false,
the button is deselected. This property is used only if the
buttonType property is set to XmCHECKBUTTON or
XmRADIOBUTTON.
- toolTipText
- The toolTipTextproperty specifies the text that is displayed
when the mouse pointer is positioned over the control. This is similar
to the hover help capability supplied by other VisualAge parts.