Share via


IUIAutomationStructureChangedEventHandler::HandleStructureChangedEvent Method

Handles an event that is raised when the Microsoft UI Automation tree structure has changed.

Syntax

HRESULT HandleStructureChangedEvent(      
    IUIAutomationElement *sender,
    StructureChangeType changeType,
    SAFEARRAY *runtimeId[int]
);

Parameters

  • sender
    [in] The address of the IUIAutomationElement interface of the element that raised the event.
  • changeType
    [in] A value from the StructureChangeType enumerated type indicating the type of tree structure change that took place.
  • runtimeId
    [in] The address of a SAFEARRAY that receives the runtime identifier of the element. This parameter is used only when changeType is StructureChangeType_ChildRemoved; it is NULL for all other structure-change events.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method is implemented by the application to handle events that it has subscribed to by using IUIAutomation::AddStructureChangedEventHandler

See Also

Working with Safe Arrays