TTMSFNCDataGridCellControlInfo Class
Snapshot of a cell control's configuration used as the key for the control bitmap cache.
API unit family: TMSFNCDataGridCell
Syntax
TTMSFNCDataGridCellControlInfo = class
class PASCALIMPLEMENTATION TTMSFNCDataGridCellControlInfo : public System::TObject
Remarks
Controls that are not shown live are painted from a bitmap. The bitmap is cached in a list shared by all cells, and a cell whose control info Compares equal to a cached entry reuses that bitmap instead of taking a new screenshot.
The key holds the control class, size, Text and Caption (read through RTTI), focus state, Tag, and ExtraHash. Descendants add state that changes the look, such as TTMSFNCDataGridCheckedCellControlInfo.Checked. When a custom control has other visual state, list its property names in TTMSFNCCustomDataGrid.OnGetCellControlExtraProperties so they become part of the key.
Properties
| Name | Description |
|---|---|
| Caption | Value of the control's Caption property at capture time, when the control has one. |
| ExtraHash | Concatenated Name=Value; pairs of the extra properties requested through TTMSFNCCustomDataGrid.OnGetCellControlExtraProperties. |
| Focused | When True, the control had keyboard focus when the cache entry was created; when False, it did not. |
| Height | Height of the control rectangle in the cell at capture time. |
| Tag | Tag value of the control at capture time. |
| Text | Value of the control's Text property at capture time, when the control has one. |
| Width | Width of the control rectangle in the cell at capture time. |
Methods
| Name | Description |
|---|---|
| Compare | Returns True when AInfo describes the same control appearance, so a bitmap cached for one can be drawn for the other. |
| CopyInstance | Creates a new control info with the same field values. |