TTMSFNCDataGridBitmapCell Class
Cell that draws a TTMSFNCBitmap; supports aspect-ratio preservation, centred placement, stretching, and cropping modes.
API unit family: TMSFNCDataGridCell
Inherits from: TTMSFNCDataGridCell
Syntax
TTMSFNCDataGridBitmapCell = class(TTMSFNCDataGridCell)
Remarks
The bitmap is rendered directly via DrawControl; no embedded live control is used. Set BitmapName to reference an image in the grid's BitmapContainer by name instead of assigning Bitmap directly.
Properties
| Name | Description |
|---|---|
| Bitmap | The TTMSFNCBitmap drawn inside the cell. |
| BitmapAlign | Docking alignment of the bitmap within the cell; controls which edge the image is anchored to. |
| 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. |
| BitmapContainer | Optional bitmap container used to resolve named bitmaps referenced by BitmapName. (inherited from TTMSFNCDataGridCell) |
| BitmapCropped | When True the bitmap is cropped to the cell bounds rather than scaled; defaults to False. |
| BitmapHeight | Explicit height of the drawn bitmap area in logical pixels; 0 means use the bitmap's natural height. |
| BitmapName | Name of a bitmap in the associated BitmapContainer to display instead of the Bitmap property. |
| BitmapStretched | When True the bitmap is stretched to fill the cell area; defaults to False. |
| BitmapWidth | Explicit width of the drawn bitmap area in logical pixels; 0 means use the bitmap's natural width. |
| Bottom | Bottom edge of the cell rectangle in canvas coordinates. (inherited from TTMSFNCDataGridCell) |
| ClipRect | Clipping rectangle applied during drawing; typically the visible viewport intersection. (inherited from TTMSFNCDataGridCell) |
| Column | Zero-based column index of this cell in the grid. (inherited from TTMSFNCDataGridCell) |
| Comment | Comment text shown in the tooltip and as the comment indicator when CommentIndicator is True. (inherited from TTMSFNCDataGridCell) |
| CommentIndicator | When True a small triangle is drawn in the cell corner to indicate the presence of a Comment; defaults to False. (inherited from TTMSFNCDataGridCell) |
| CommentIndicatorColor | Colour of the comment indicator triangle; defaults to gcOrange. (inherited from TTMSFNCDataGridCell) |
| CommentIndicatorRect | Bounding rectangle of the comment indicator triangle within the cell. (inherited from TTMSFNCDataGridCell) |
| Control | The live embedded VCL/FMX control displayed inside the cell, if any. (inherited from TTMSFNCDataGridCell) |
| ControlAlign | Docking mode for the embedded control; defaults to gcaNone. (inherited from TTMSFNCDataGridCell) |
| ControlClipping | When True the embedded control is clipped to the cell bounds; defaults to True. (inherited from TTMSFNCDataGridCell) |
| ControlMargins | Margins applied around the embedded control within the cell content area. (inherited from TTMSFNCDataGridCell) |
| ControlPosition | Nine-point placement position for the embedded control when ControlAlign is gcaNone; defaults to gcpCenterRight. (inherited from TTMSFNCDataGridCell) |
| ControlRect | Computed rectangle occupied by the embedded control within the cell. (inherited from TTMSFNCDataGridCell) |
| Coordinate | Column/row coordinate of this cell expressed as a TTMSFNCDataGridCellCoord record. (inherited from TTMSFNCDataGridCell) |
| Data | The cell data item providing Value, DisplayValue, and extended metadata. (inherited from TTMSFNCDataGridCell) |
| DrawElements | Set of draw elements painted during the next Draw call; defaults to FullElements. (inherited from TTMSFNCDataGridCell) |
| FilterButton | When True an inline filter button is drawn in the cell; defaults to False. (inherited from TTMSFNCDataGridCell) |
| FilterButtonRect | Bounding rectangle of the filter button glyph within the cell. (inherited from TTMSFNCDataGridCell) |
| Height | Height of the cell rectangle in logical pixels. (inherited from TTMSFNCDataGridCell) |
| IsExporting | True while the grid is performing an export render pass; False during normal display. (inherited from TTMSFNCDataGridCell) |
| Kind | Structural kind of this cell (data, fixed header, frozen pane, etc.). (inherited from TTMSFNCDataGridCell) |
| Layout | Appearance layout controlling fill, font, borders, and text style for this cell. (inherited from TTMSFNCDataGridCell) |
| Left | Left edge of the cell rectangle in canvas coordinates. (inherited from TTMSFNCDataGridCell) |
| Rect | Bounding rectangle of the cell in canvas coordinates. (inherited from TTMSFNCDataGridCell) |
| Right | Right edge of the cell rectangle in canvas coordinates. (inherited from TTMSFNCDataGridCell) |
| Row | Zero-based row index of this cell in the grid. (inherited from TTMSFNCDataGridCell) |
| Scale | Display scale factor (DPI scaling) applied when rendering this cell. (inherited from TTMSFNCDataGridCell) |
| SortIndicator | Sort-direction glyph shown in fixed header cells; defaults to gsiNone. (inherited from TTMSFNCDataGridCell) |
| SortIndicatorRect | Bounding rectangle of the sort indicator glyph within the cell. (inherited from TTMSFNCDataGridCell) |
| Text | The text string rendered in this cell, derived from DisplayValue or the formatted Value. (inherited from TTMSFNCDataGridCell) |
| TextRect | Computed rectangle available for text rendering after reserving space for the control, sort indicator, and filter button. (inherited from TTMSFNCDataGridCell) |
| Top | Top edge of the cell rectangle in canvas coordinates. (inherited from TTMSFNCDataGridCell) |
| Width | Width of the cell rectangle in logical pixels. (inherited from TTMSFNCDataGridCell) |
Methods
| Name | Description |
|---|---|
| AfterExport | Called by the grid after export is complete; restores any state changed by BeforeExport. (inherited from TTMSFNCDataGridCell) |
| BeforeExport | Called by the grid before export begins; prepares the cell for export rendering. (inherited from TTMSFNCDataGridCell) |
| ClearControlCache | Invalidates and releases the cached control bitmap so the control is re-rendered on the next draw. (inherited from TTMSFNCDataGridCell) |
| Draw | Performs a full repaint of the cell using AGraphics; calls DrawBackground, DrawContent, and all other draw sub-steps. (inherited from TTMSFNCDataGridCell) |
| DrawBackground | Draws the cell background fill and border stroke according to the current Layout. (inherited from TTMSFNCDataGridCell) |
| DrawCommentIndicator | Draws the comment indicator triangle in the cell corner when CommentIndicator is True. (inherited from TTMSFNCDataGridCell) |
| DrawContent | Draws all cell content (text, control, sort indicator, filter button, comment indicator). (inherited from TTMSFNCDataGridCell) |
| DrawControl | Draws the embedded control bitmap or live control within the cell's control rectangle. (inherited from TTMSFNCDataGridCell) |
| DrawFilterButton | Draws the inline filter button glyph when FilterButton is True. (inherited from TTMSFNCDataGridCell) |
| DrawSortIndicator | Draws the sort-direction indicator glyph according to SortIndicator. (inherited from TTMSFNCDataGridCell) |
| DrawText | Draws the cell text string inside the TextRect according to the current Layout alignment and trimming settings. (inherited from TTMSFNCDataGridCell) |
| HandleKey | Delivers a keyboard event to the cell; subclasses override to handle key interactions. (inherited from TTMSFNCDataGridCell) |
| HandleMouse | Delivers a mouse event to the cell; subclasses override to handle mouse interactions. (inherited from TTMSFNCDataGridCell) |
| IsHTML | Returns True when the cell's text contains HTML markup that the renderer should parse. (inherited from TTMSFNCDataGridCell) |
| ReInitialize | Re-initialises a pooled cell instance with new coordinates and data without allocating a new object. (inherited from TTMSFNCDataGridCell) |
| XYToAnchor | Returns the anchor URL at canvas position (X, Y) within the cell, or an empty string when no anchor is hit. (inherited from TTMSFNCDataGridCell) |