Drag Enter Event
Installed With: Full Development System
Class: Control Events
Type: Notify
Generated when there is a drag operation pending and the cursor enters the bounds of a control.
Use this event to report to the drag source if this drop target accepts the dragged data.
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. | ||
| Available Data Names | Array of unique names of data types available during this drag and drop operation. Use this array to determine if a data type is available that the drop target can accept | ||
| Accepted? | Reports to the drag source the action that the drop target would take if the drop occurred at this moment. TRUE, if the target would accept the drop, FALSE otherwise. |
Example
Refer to the Drag and Drop - Custom Source Handle Dropping VI in the labview\examples\general\dragdrop directory for an example of using the Drag Enter event.
Open example Browse related examples