IUIAutomationDragPattern::GetCachedGrabbedItems-Methode (uiautomationclient.h)

  • Artikel

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)

Weitere Informationen

IUIAutomationDragPattern