IDragProvider::GetGrabbedItems-Methode (uiautomationcore.h)
Ruft die Auflistung von Elementen ab, die im Rahmen eines Ziehvorgangs gezogen werden.
Syntax
HRESULT GetGrabbedItems(
[out, retval, optional] SAFEARRAY **pRetVal
);
Parameter
[out, retval, optional] pRetVal
Ein Array von VT_UNKNOWN Zeiger auf die IRawElementProviderSimple-Schnittstellen der Elemente, die gezogen werden. Dieser Parameter ist NULL , wenn nur ein einzelnes Element gezogen wird.
Rückgabewert
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 GetGrabbedItems aufrufen, um die vollständige Liste der erfassten Elemente abzurufen. Der Anbieter sollte ein SAFEARRAY der entsprechenden Länge zuordnen und die COM-Zeiger (Component Object Model) der Elemente hinzufügen, die Teil des Ziehvorgangs sind.
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) |