IDragProvider::GetGrabbedItems-Methode (uiautomationcore.h)

  • Artikel

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)

Weitere Informationen

IDragProvider