UiaNavigate-Funktion (uiautomationcoreapi.h)

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die Microsoft Benutzeroberflächenautomatisierung COM-Schnittstellen (Component Object Model) verwenden.

 

Navigiert in der Benutzeroberflächenautomatisierung-Struktur und ruft optional zwischengespeicherte Informationen ab.

Syntax

HRESULT UiaNavigate(
  [in]  HUIANODE          hnode,
  [in]  NavigateDirection direction,
  [in]  UiaCondition      *pCondition,
  [in]  UiaCacheRequest   *pRequest,
  [out] SAFEARRAY         **ppRequestedData,
  [out] BSTR              *ppTreeStructure
);

Parameter

[in] hnode

Typ: HUIANODE

Das Element, auf dem die Navigation beginnt.

[in] direction

Typ: NavigateDirection

Ein Wert aus dem aufgezählten NavigateDirection-Typ , der die Richtung angibt, in der von hnode navigiert werden soll.

[in] pCondition

Typ: UiaCondition*

Die Adresse einer UiaCondition-Struktur , die die Bedingung angibt, zu der das Element, zu dem navigiert wird, übereinstimmen muss. Verwenden Sie diesen Parameter, um Elemente zu überspringen, die nicht von Interesse sind.

[in] pRequest

Typ: UiaCacheRequest*

Die Adresse einer UiaCacheRequest-Struktur , die eine Beschreibung der zwischengespeicherten Informationen enthält.

[out] ppRequestedData

Typ: SAFEARRAY**

Die Adresse einer Variablen, die einen Zeiger auf eine SAFEARRAY empfängt, die die angeforderten Daten enthält. Dieser Parameter wird nicht initialisiert übergeben. Siehe Hinweise.

[out] ppTreeStructure

Typ: BSTR*

Die Adresse einer Variablen, die die Beschreibung der Strukturstruktur empfängt. Dieser Parameter wird nicht initialisiert übergeben. Siehe Hinweise.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert.

Hinweise

Die Struktur wird durch eine Zeichenfolge beschrieben, bei der jedes Zeichen entweder "p" oder "") ist. Das erste Zeichen in der Zeichenfolge stellt immer den Stammknoten dar. Die Zeichenfolge ist NULL , wenn von der Funktion keine Elemente zurückgegeben werden.

Ein "p" stellt einen Knoten (Benutzeroberflächenautomatisierung-Element) dar. Wenn ein "p" direkt dem anderen folgt, ist der zweite Knoten ein untergeordnetes Element des ersten Knotens. Ein "" stellt einen Schritt nach oben in der Struktur dar. Beispielsweise steht "pp)p" für einen Knoten, gefolgt von zwei untergeordneten Knoten, die gleichgeordnet sind. In "pp))p" ist der letzte Knoten ein gleichgeordneter Knoten des ersten Knotens.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll