IDragProvider::get_DropEffect-Methode (uiautomationcore.h)

Ruft eine lokalisierte Zeichenfolge ab, die angibt, was geschieht, wenn dieses Element im Rahmen eines Drag-Drop-Vorgangs gelöscht wird.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_DropEffect(
  BSTR *pRetVal
);

Parameter

pRetVal

Rückgabewert

Keine

Bemerkungen

Im Quellstil des Drag-and-Drops der Benutzeroberflächenautomatisierung implementieren keine Elemente das DropTarget-Muster . Um herauszufinden, welche Auswirkungen das Löschen des gezogenen Elements hat, kann ein Client die DropEffect-Eigenschaft des gezogenen Elements abfragen. Diese Eigenschaft kann eine kurze Zeichenfolge wie "move" oder eine längere sein, z. B. "in Maingruppe einfügen". Die Zeichenfolge wird immer lokalisiert.

Wenn sich diese Eigenschaft ändert, muss der Anbieter Clients benachrichtigen, indem er UiaRaiseAutomationPropertyChangedEvent aufruft und einen Eigenschaftenbezeichner für UIA_DragIsGrabbedPropertyId oder UIA_DragDropEffectPropertyId angibt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

IDragProvider