IDropTargetProvider::get_DropTargetEffects-Methode (uiautomationcore.h)

  • Artikel

Ruft ein Array lokalisierter Zeichenfolgen ab, die den vollständigen Satz von Effekten aufzählen, die auftreten können, wenn der Benutzer ein gepacktes Element im Rahmen eines Drag-and-Drop-Vorgangs auf diesem Ablageziel abwirft.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_DropTargetEffects(
  SAFEARRAY **pRetVal
);

Parameter

pRetVal

Rückgabewert

Keine

Bemerkungen

Einige Ziehvorgänge unterstützen verschiedene Drop-Effekte. Beispielsweise kann bei einem Ziehvorgang, der mit einem Rechtsklick initiiert wird, ein Menü mit Optionen für die Aktion angezeigt werden, die beim Löschen des Elements auftritt. Um herauszufinden, welche Auswirkungen 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 Hauptgruppe einfügen" enthalten. 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 (uiAutomation.h einschließen)

Weitere Informationen

IDropTargetProvider