Parts Reference


Status Panel properties

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.

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:

  1. Define the label with the Number data type.
  2. Assign a value to the label.
  3. 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.

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.

shadowType
The shadowType property specifies the type of shadow you want to appear around the part.

width
The width property specifies the amount of horizontal space occupied by the status panel. You can also use the mouse to resize the status panel in the Composition Editor.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]