UiaRaiseStructureChangedEvent function

Called by a provider to notify the Microsoft UI Automation core that the tree structure has changed.

Syntax

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

Parameters

pProvider

Type: IRawElementProviderSimple*

The provider node where the tree change occurred.

structureChangeType

Type: StructureChangeType

The type of change that occurred in the tree.

pRuntimeId

Type: int*

The runtime IDs for the child elements of the provider node where the tree change occurred. This parameter is used only when structureChangeType is StructureChangeType_ChildRemoved; it is NULL for all other structure-change events.

Note  For Windows 7, the array of integers pointed to by pRuntimeId can contain a partial set of IDs that identify only those elements affected by the structure change.
 

cRuntimeIdLen

Type: int

Length of the array of integers.

Return Value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

An example of a change in the tree structure is child elements being added to or removed from a list box, or being expanded or collapsed in a tree view.

Requirements

   
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header uiautomationcoreapi.h
Library Uiautomationcore.lib
DLL Uiautomationcore.dll