UiaEventCallback-Rückruffunktion (uiautomationcoreapi.h)

Artikel
08/26/2023

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen (Component Object Model) von Microsoft UI Automation verwenden.

Eine vom Client implementierte Funktion, die von der Benutzeroberflächenautomatisierung aufgerufen wird, wenn ein Ereignis ausgelöst wird, das der Client abonniert hat.

Syntax

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

Parameter

[in] pArgs

Typ: UiaEventArgs*

Die Adresse einer UiaEventArgs-Struktur , die die Ereignisargumente enthält.

[in] pRequestedData

Typ: SAFEARRAY*

Ein SAFEARRAY-Objekt , das dem Ereignis zugeordnete Daten enthält.

[in] pTreeStructure

Typ: BSTR

Eine Zeichenfolge, die die Struktur der Struktur enthält, die dem Ereignis zugeordnet ist, wenn das Ereignis einer Reihe von Knoten zugeordnet ist. Siehe Hinweise.

Rückgabewert

Keine

Bemerkungen

Diese Funktion wird an UiaAddEvent und UiaRemoveEvent übergeben.

Die Strukturstruktur 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 (UI Automation-Element) dar. Wenn ein "p" direkt auf den anderen folgt, ist der zweite Knoten ein untergeordneter Knoten des ersten. Ein "" stellt einen Schritt zur Sicherung der Struktur dar. Beispielsweise stellt "pp)p" einen Knoten gefolgt von zwei untergeordneten Knoten dar, die gleichgeordnet sind. In "pp))p" ist der letzte Knoten ein gleichgeordneter Knoten des ersten Knotens.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h

Freigeben über