IUIAutomationDropTargetPattern::get_CachedDropTargetEffects-Methode (uiautomationclient.h)

  • Artikel

Ruft ein zwischengespeichertes 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 für dieses Ablageziel abwirft.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_CachedDropTargetEffects(
  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

   
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

IUIAutomationDropTargetPattern