Drag Starting? Event
Installed With: Full Development System
Class: ListBox Events
Type: Filter
Generated when you start a drag from a listbox control.
Use this event to signal when a drag and drop operation begins from a specific control. This event is generated only when LabVIEW begins a drag and drop operation on a listbox control. You can use the Start Drag method to begin a drag from other controls.
Event Data Fields
| Name | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Source | Source of the event. LabVIEW UI refers to any built-in user interface event.
| ||||||||||||||
| Type | Type of event that occurred, such as Mouse Down, Value Change, Timeout, and so on. | ||||||||||||||
| Time | Value of the millisecond timer when the event occurred. | ||||||||||||||
| CtlRef | Reference to the control on which the event occurred. | ||||||||||||||
| Coords | Coordinates of the location of the mouse click at the time the event occurs. Coordinates are relative to the drop target's owning pane origin, excluding clusters. | ||||||||||||||
| Button | Value that corresponds to which mouse button the user clicked. Left mouse button is 1, right mouse button is 2. Operating systems might assign higher numbers if you have a mouse with more than two buttons. For filter events, you can modify the data returned by this event data field. | ||||||||||||||
| Mods | Cluster of Booleans that contain platform-independent modifiers. LabVIEW returns all platform-dependent modifiers in the PlatMods event data field. For key events, this event returns a Boolean indicating if the event occurred on the numeric keypad. For mouse events, this event returns a Boolean indicating if the event was a double-click. For both events, a Boolean is returned if the platform-independent menu key, such as <Ctrl> on Windows or <Command> on Mac OS, was pressed when the event occurred. For filter events, you can modify the data returned by this event data field. | ||||||||||||||
| PlatMods | Cluster of Booleans that contain platform-dependent modifiers. Specifies if platform-dependent keys, such as <Ctrl>, <Shift>, <Alt>, <Command>, and <Option> were held down when the event was triggered. For filter events, you can modify the data returned by this event data field. A key can be both a Mod and PlatMod. For example, <Ctrl> is the platform-independent menu key on Windows, but you also can use it in platform-dependent programming. | ||||||||||||||
| Drag Data | Indicates the data provided during the drag and drop operation. For filter events, you can modify this field to provide your own custom data for the drag and drop operation.
You cannot use the prefix LV_ on a user-defined data name, because it is reserved for LabVIEW data types. You can use the built-in LabVIEW data types and names.
| ||||||||||||||
| Drag Mode | Specifies the operations that this control supports during the drag, such as copy or move, copy only, move only. If you select copy or move, pressing the <Ctrl> key copies the item. For filter events, you can modify this field to change the drag mode when this event is generated. | ||||||||||||||
| Discard? | Allows you to prevent LabVIEW from processing the event, bypassing the behavior normally triggered by that event. The default is FALSE. |
Example
Refer to the Drag and Drop - Built-in Source Custom Data VI in the labview\examples\general\dragdrop directory for an example of using the Drag Starting? event.
Open example Browse related examples