UiaEventCallback callback function (uiautomationcoreapi.h)

Syntax

UiaEventCallback Uiaeventcallback;

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

Parameters

[in] pArgs

Type: UiaEventArgs*

The address of a UiaEventArgs structure that contains the event arguments.

[in] pRequestedData

Type: SAFEARRAY*

A SAFEARRAY that contains data associated with the event.

[in] pTreeStructure

Type: BSTR

A string that contains the structure of the tree associated with the event, if the event is associated with a set of nodes. See Remarks.

Return value

None

Remarks

This function is passed to UiaAddEvent and UiaRemoveEvent.

The tree structure is described by a string where every character is either "p" or ")". The first character in the string always represents the root node. The string is NULL if no elements are returned by the function.

A "p" represents a node (UI Automation element). When one "p" directly follows another, the second node is a child of the first. A ")" represents a step back up the tree. For example, "pp)p" represents a node followed by two child nodes that are siblings of one another. In "pp))p", the last node is a sibling of the first one.

Requirements