IDragProvider::get_DropEffects-Methode (uiautomationcore.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 gelöscht wird.
Diese Eigenschaft ist schreibgeschützt.
Syntax
HRESULT get_DropEffects(
SAFEARRAY **pRetVal
);
Parameter
pRetVal
Rückgabewert
Keine
Bemerkungen
Einige Ziehvorgänge unterstützen eine Reihe unterschiedlicher Ablageeffekte. Ein Ziehvorgang, der über einen Rechtsklick initiiert wird, kann beispielsweise ein Menü mit Optionen anzeigen, wenn das Element gelöscht wird. Im Quellstil von Microsoft Benutzeroberflächenautomatisierung drag-and-drop 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 Zeichenfolgen werden immer lokalisiert.
Anforderungen
Anforderung | Wert |
---|---|
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) |