IDragProvider::get_DropEffects-Methode (uiautomationcore.h)

  • Artikel

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)

Weitere Informationen

IDragProvider