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) |