IDragProvider interface

Enables a Microsoft UI Automation element to describe itself as an element that can be dragged as part of a drag-and-drop operation.

When to implement

A UI Automation element implements this interface if it can be dragged in a drag-and-drop operation. If an element implements this interface, the interface should be available even when no drag operation is in progress, in which case the interface indicates that the user could drag this item.

Members

The IDragProvider interface inherits from the IUnknown interface. IDragProvider also has these types of members:

Methods

The IDragProvider interface has these methods.

MethodDescription
GetGrabbedItems

Retrieves the collection of elements that are being dragged as part of a drag operation.

 

Properties

The IDragProvider interface has these properties.

PropertyAccess typeDescription

DropEffect

Read-only

Retrieves a localized string that indicates what happens when this element is dropped as part of a drag-drop operation.

DropEffects

Read-only

Retrieves an array of localized strings that enumerate the full set of effects that can happen when this element is dropped as part of a drag-and-drop operation.

IsGrabbed

Read-only

Indicates whether the element has been grabbed as part of a drag-and-drop operation.

 

Remarks

A provider can implement IDragProvider only on the element being dragged, or it can use an intermediary drag object that implements IDragProvider, in addition to the IDragProvider implementation on the individual element. The intermediary is responsible for firing all events, which enables the provider to support dragging multiple elements at once, and to describe the multi-element drag operation with a single set of drag properties and events.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

UIAutomationCore.h (include UIAutomation.h)

IDL

UIAutomationCore.idl

DLL

UIAutomationCore.dll

IID

IID_IDragProvider is defined as 6aa7bbbb-7ff9-497d-904f-d20b897929d8

See also

IDropTargetProvider
UI Automation Support for Drag-and-Drop

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.