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) |