TTMSFNCDataGridConditionalFormatting.EvaluateCellAppearance Method
Main entry point for the appearance pass. Applies every enabled, matching, non-overlay rule to for the given cell, honouring TTMSFNCDataGridFormatRuleItem.Priority and TTMSFNCDataGridFormatRuleItem.StopIfTrue.
API unit family: TMSFNCDataGridConditionalFormatting
Declaring type: TTMSFNCDataGridConditionalFormatting
Syntax
function EvaluateCellAppearance(const AProvider: ITMSFNCDataGridFormatProvider; AColumn, ARow: Integer; ALayout: TTMSFNCDataGridCellLayout): Boolean;
bool __fastcall EvaluateCellAppearance(const _di_ITMSFNCDataGridFormatProvider AProvider, int AColumn, int ARow, TTMSFNCDataGridCellLayout* ALayout);
Remarks
Rules run from the lowest Priority upwards and each claims the appearance aspects it sets, so the highest-priority match owns an aspect and lower-priority rules only contribute the aspects still free. A rule can therefore match without changing anything when every aspect it sets is already owned.
Call from the renderer's cell configuration step, after the layout is set and before any further layout callback. Statistics for aggregate rules are built on first use and cached until InvalidateStats. Application code normally does not call this method; the grid invokes it while painting.
Parameters
| Name | Description |
|---|---|
AProvider |
The grid-data provider used to read cell values and statistics. |
AColumn |
Zero-based column index of the cell being evaluated. |
ARow |
Zero-based row index of the cell being evaluated. |
ALayout |
The cell layout to merge matching rules' appearance into. |
Returns
True if at least one rule matched the cell, including an overlay rule that changes no appearance; False when nothing matched, the collection is disabled or empty, is nil, or the cell is not a data cell.