IUIAutomationDropTargetPattern::get_CurrentDropTargetEffects-Methode (uiautomationclient.h)
Ruft ein Array lokalisierter Zeichenfolgen ab, das den vollständigen Satz von Effekten auflistet, die auftreten können, wenn der Benutzer im Rahmen eines Drag-and-Drop-Vorgangs ein erfasstes Element auf diesem Ablageziel abwirft.
Diese Eigenschaft ist schreibgeschützt.
Syntax
HRESULT get_CurrentDropTargetEffects(
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. 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) |