IDropTargetProvider interface

Applies to Windows and Windows Phone

Enables a Microsoft UI Automation element to describe itself as an element that can receive a drop of a dragged element as part of a drag-and-drop operation. Implement this interface in order to support the capabilities that an automation client requests with a GetPattern call and PatternInterface.DropTarget.

Syntax


public interface IDropTargetProvider

Attributes

[Version(0x06020000)]
[WebHostHidden()]

Members

The IDropTargetProvider interface has these types of members:

Properties

The IDropTargetProvider interface has these properties.

PropertyAccess typeDescription

DropEffect

Read-onlyGets a string that indicates what will happen when the item is dropped.

DropEffects

Read-onlyGets an array of strings that enumerates possible drop effects when this item is dropped.

 

Remarks

A drop target reports the action if the user drops the dragged item on the peer's owner as drop target. These action results are called effects. The effects are descriptive strings, not visual effects in a UI and design sense. For more info on what this pattern is for, see DropTarget Control Pattern.

IDropTargetProvider is implemented by the existing Windows Runtime automation peers for a ListView or GridView (ListViewAutomationPeer, GridViewAutomationPeer). This supports the Windows Runtime scenario of dragging list items so that they can be reordered. There are a limited number of Windows Runtime classes that can be a drag source; these sources support the IDragProvider pattern for automation purposes.

Use DropTargetPatternIdentifiers if you want to reference the IDropTargetProvider pattern properties from control code when you fire automation events or call RaisePropertyChangedEvent.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Automation.Provider
Windows::UI::Xaml::Automation::Provider [C++]

Metadata

Windows.winmd

See also

DropTargetPatternIdentifiers
IDropTargetProvider (COM interface)
Custom automation peers
DropTarget Control Pattern

 

 

Show:
© 2014 Microsoft