IUIAutomationDragPattern::get_CurrentDropEffects-Methode (uiautomationclient.h)
Ruft ein Array lokalisierter Zeichenfolgen ab, das den vollständigen Satz von Effekten auflistet, die auftreten können, wenn dieses Element im Rahmen eines Drag-and-Drop-Vorgangs auftreten kann.
Diese Eigenschaft ist schreibgeschützt.
Syntax
HRESULT get_CurrentDropEffects(
SAFEARRAY **retVal
);
Parameter
retVal
Rückgabewert
Keine
Bemerkungen
Einige Ziehvorgänge unterstützen eine Reihe unterschiedlicher Ablageeffekte. Beispielsweise kann ein Ziehvorgang, der mit einem Rechtsklick initiiert wird, ein Menü mit Optionen für die Aktion anzeigen, die beim Löschen des Elements auftritt. Im Quellstil von Microsoft Benutzeroberflächenautomatisierung drag-and-drop implementieren keine Elemente das DropTarget-Muster. Um die Auswirkungen zu ermitteln, die auftreten können, wenn das grabbed-Element gelöscht wird, kann ein Client die DropEffects-Eigenschaft des gezogenen Elements abfragen. Diese Eigenschaft kann kurze Zeichenfolgen wie "move" oder längere Zeichenfolgen wie "in Maingruppe einfügen" enthalten. Die Zeichenfolgen werden immer lokalisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiautomationclient.h (include UIAutomation.h) |