IUIAutomationDragPattern::GetCachedGrabbedItems-Methode (uiautomationclient.h)
Ruft eine zwischengespeicherte Auflistung von Elementen ab, die den vollständigen Satz von Elementen darstellen, die der Benutzer im Rahmen eines Ziehvorgangs ziehe.
Syntax
HRESULT GetCachedGrabbedItems(
[out, retval, optional] IUIAutomationElementArray **retVal
);
Parameter
[out, retval, optional] retVal
Typ: IAutomationElementArray**
Die zwischengespeicherte Auflistung von Elementen, 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 Element löst die entsprechenden Ereignisse aus, um einen großen Satz doppelter Ereignisse zu vermeiden. Der Client kann die GrabbedItems-Eigenschaft abfragen, um die vollständige Liste der erfassten Elemente abzurufen.
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) |