IUIAutomationDragPattern::GetCurrentGrabbedItems-Methode (uiautomationclient.h)

Ruft eine Auflistung von Elementen ab, die den vollständigen Satz von Elementen darstellen, die der Benutzer als Teil eines Ziehvorgangs zieht.

Syntax

HRESULT GetCurrentGrabbedItems(
  [out, retval, optional] IUIAutomationElementArray **retVal
);

Parameter

[out, retval, optional] retVal

Typ: IAutomationElementArray**

Die Auflistung der Elemente, die der Benutzer zieht. Diese Eigenschaft ist NULL oder ein leeres Array, wenn nur ein einzelnes Element gezogen wird. Der Standardwert ist ein leeres Array.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der Benutzer mehrere Elemente zieht, werden die Elemente durch ein einzelnes master-Element mit einem zugeordneten Satz von erfassten Elementen dargestellt. Das master Elements löst die entsprechenden Ereignisse aus, um zu vermeiden, dass eine große Gruppe doppelter Ereignisse vorhanden ist. Der Client kann die GrabbedItems-Eigenschaft abfragen, um die vollständige Liste der erfassten Elemente abzurufen.

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

IUIAutomationDragPattern