IUIAutomationDragPattern::get_CurrentDropEffects-Methode (uiautomationclient.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 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)

Weitere Informationen

IUIAutomationDragPattern