Funzione UiaRaiseStructureChangedEvent (uiautomationcoreapi.h)

Articolo
03/03/2024

Chiamato da un provider per notificare a Microsoft Automazione interfaccia utente core che la struttura ad albero è stata modificata.

Sintassi

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

Parametri

[in] pProvider

Tipo: IRawElementProviderSimple*

Nodo del provider in cui si è verificata la modifica dell'albero.

[in] structureChangeType

Tipo: StructureChangeType

Tipo di modifica che si è verificata nell'albero.

[in] pRuntimeId

Tipo: int*

ID di runtime per gli elementi figlio del nodo del provider in cui si è verificata la modifica dell'albero. Questo parametro viene usato solo quando structureChangeType è StructureChangeType_ChildRemoved; è NULL per tutti gli altri eventi di modifica della struttura.

Nota Per Windows 7, la matrice di numeri interi a cui punta pRuntimeId può contenere un set parziale di ID che identificano solo gli elementi interessati dalla modifica della struttura.

[in] cRuntimeIdLen

Tipo: int

Lunghezza della matrice di numeri interi.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un esempio di modifica nella struttura ad albero è costituito dall'aggiunta o dalla rimozione di elementi figlio da una casella di riepilogo o espansi o compressi in una visualizzazione albero.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Condividi tramite