TdxTreeListAutomationSettings.OnCalculateRowProperty Event

Allows you to modify UIA node properties for individual rows depending on certain conditions.

Declaration

property OnCalculateRowProperty: TdxTreeListCalculateRowAutomationPropertyEvent read; write;

Remarks

You can handle the OnCalculateRowProperty event to modify individual UIA node properties depending on certain conditions.

Event Occurrence

The OnCalculateRowProperty event occurs every time a UIA client requests an individual node property for a row (multiple times – once per node property).

Automatic and Manual UIA Property Calculation

Automatic

Default. The OnCalculateRowProperty event occurs automatically for each property of a UIA node corresponding to a row if the dxUIACalculateAllProperties global variable is set to True.

Manual

You can set the dxUIACalculateAllProperties variable to False to disable automatic calculation for all UIA properties. In this mode, handle the OnInitializeRowProperties event for each required data row to specify individual UIA node properties you need to calculate.

Event Parameters

The following parameters are available within an OnCalculateRowProperty event handler:

ARow

Provides access to the row (node) that raised the OnCalculateRowProperty event.

AProperty

Provides access to the calculated UI node property.

AProperties

Provides access to the list of all UIA node properties for the processed row (ARow).

You can use AProperties.Name and AProperties.FullDescription properties to modify corresponding UIA node properties for the processed row (ARow).

Refer to the TdxTreeListCalculateRowAutomationPropertyEvent procedural type description for detailed information on all parameters accessible within an OnCalculateRowProperty event handler.