UiaRaiseStructureChangedEvent-Funktion (uiautomationcoreapi.h)

Artikel
03/06/2024

Wird von einem Anbieter aufgerufen, um den Microsoft Benutzeroberflächenautomatisierung Kern zu benachrichtigen, dass sich die Struktur geändert hat.

Syntax

HRESULT UiaRaiseStructureChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] StructureChangeType       structureChangeType,
  [in] int                       *pRuntimeId,
  [in] int                       cRuntimeIdLen
);

Parameter

[in] pProvider

Typ: IRawElementProviderSimple*

Der Anbieterknoten, auf dem die Strukturänderung stattgefunden hat.

[in] structureChangeType

Typ: StructureChangeType

Der Typ der Änderung, die in der Struktur aufgetreten ist.

[in] pRuntimeId

Typ: int*

Die Laufzeit-IDs für die untergeordneten Elemente des Anbieterknotens, auf dem die Strukturänderung stattgefunden hat. Dieser Parameter wird nur verwendet, wenn structureChangeTypeStructureChangeType_ChildRemoved ist. es ist NULL für alle anderen Strukturänderungsereignisse.

Hinweis Für Windows 7 kann das Array von ganzen Zahlen, auf das von pRuntimeId verwiesen wird, einen Teilsatz von IDs enthalten, die nur die von der Strukturänderung betroffenen Elemente identifizieren.

[in] cRuntimeIdLen

Typ: int

Länge des Arrays von ganzen Zahlen.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein Beispiel für eine Änderung in der Struktur ist, dass untergeordnete Elemente einem Listenfeld hinzugefügt oder daraus entfernt werden oder in einer Strukturansicht erweitert oder reduziert werden.

Anforderungen

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

Freigeben über