TTMSFNCDataGridCellItemExtended Class
Full-featured cell data object extending TTMSFNCDataGridCellItem with bitmap, typed data slots, comments, embedded controls, merge spans, and layout overrides.
API unit family: TMSFNCDataGridCell
Inherits from: TTMSFNCDataGridCellItem
Implements: ITMSFNCCustomReadWriteIO
Syntax
TTMSFNCDataGridCellItemExtended = class(TTMSFNCDataGridCellItem, ITMSFNCCustomReadWriteIO)
Remarks
Obtain an instance via Cells[Col, Row].AsExtended or the AsExtendedCell() free function. The ManagedObject property transfers ownership to the cell and is freed when the cell is destroyed. LayoutPersistence controls which layout properties survive a global appearance refresh.
Properties
| Name | Description |
|---|---|
| Bitmap | Bitmap drawn in the cell when Type is gcitBitmap. |
| BitmapAspectRatio | When True the bitmap preserves its aspect ratio during rendering; defaults to True. |
| BitmapCentered | When True the bitmap is centred within the cell area; defaults to True. |
| BitmapCropped | When True the bitmap is cropped to the cell bounds rather than scaled; defaults to False. |
| BitmapName | Name of a bitmap in the associated BitmapContainer to use instead of the Bitmap property. |
| BitmapStretched | When True the bitmap is stretched to fill the cell area; defaults to False. |
| BooleanValue | Boolean value used as the checked state for gcitCheckBox and gcitRadioButton cell types. When True, the control is checked; when False, it is unchecked. |
| ColumnOffset | Column offset of the top-left anchor cell in a merged range; part of the merge geometry shortcut. |
| ColumnSpan | Number of columns spanned by this merged cell; 1 means no column merging. |
| Comment | Tooltip text shown as a comment indicator in the cell corner; also used as the hover hint. |
| Control | Optional live VCL/FMX control embedded inside the cell; set by the renderer when gcitButton etc. is active. |
| ControlAlign | Docking mode for the embedded control; defaults to gcaNone (position-based placement). |
| ControlHeight | Explicit height for the embedded control in pixels; -1 means auto-size. |
| ControlMargins | Margins applied around the embedded control within the cell. |
| ControlPosition | Nine-point placement position for the embedded control when ControlAlign is gcaNone; defaults to gcpCenterRight. |
| ControlText | Text label displayed on the embedded control (e.g. button caption). |
| ControlWidth | Explicit width for the embedded control in pixels; -1 means auto-size. |
| DataBoolean | Typed boolean data slot available for application use. When True, the application flag is set; when False, it is not set. |
| DataInteger | Typed integer data slot available for application use; not interpreted by the grid. |
| DataObject | Typed TObject data slot available for application use; not owned by the cell. |
| DataPointer | Typed pointer data slot available for application use; not freed by the cell. |
| DataString | Typed string data slot available for application use; not interpreted by the grid. |
| DisplayValue | Formatted display string shown in the cell; when non-empty it takes precedence over the raw Value for rendering. (inherited from TTMSFNCDataGridCellItem) |
| Hint | Hint string shown when the user hovers over the cell. |
| IntegerValue | Integer value used as the progress-bar position for gcitProgressBar cell types. |
| Invalid | When True the cell is flagged for a repaint on the next render pass; reset by the renderer after drawing. (inherited from TTMSFNCDataGridCellItem) |
| LayoutPersistence | Bitmask controlling which layout properties persist across a global appearance refresh; 0 means no persistence. |
| ManagedObject | Owned TObject that is automatically freed when this cell item is destroyed. |
| MergeInfo | Span descriptor describing the merge geometry for this cell; see TTMSFNCDataGridCellMergeInfo. |
| RadioGroupIndex | Group index shared by radio-button cells in the same logical group; defaults to 0. |
| ReadOnly | When True the cell cannot be edited by the user; defaults to False. |
| RowOffset | Row offset of the top-left anchor cell in a merged range; part of the merge geometry shortcut. |
| RowSpan | Number of rows spanned by this merged cell; 1 means no row merging. |
| Value | The underlying TValue (or JSValue on Web) stored for this cell. (inherited from TTMSFNCDataGridCellItem) |
Methods
| Name | Description |
|---|---|
| Clear | Resets the cell's Value, DisplayValue, and Invalid flag to empty/default state. (inherited from TTMSFNCDataGridCellItem) |
| HasMergeInfo | Returns True when this cell has a non-default (non-zero) MergeInfo record attached. |