TTMSFNCTileListItem Class
A single tile in a
TTMSFNCTileList, with a title, description, image, optional embedded control, badge text, span settings, and application-defined data.
API unit family: TMSFNCTileList
Inherits from: TCollectionItem
Syntax
TTMSFNCTileListItem = class(TCollectionItem)
Properties
| Name | Description |
|---|---|
| Badge | Text displayed in the tile's badge overlay (typically a notification count). |
| CanDeselect | When True, the user can click a selected tile to deselect it. |
| CanSelect | When True, the user can click the tile to select it. |
| ColumnSpan | Number of grid columns this tile occupies. |
| Control | Optional VCL/FMX/WEB control embedded inside the tile. |
| ControlHeight | Height of the embedded control in pixels; pass 0 to use the control's natural height. |
| ControlLeft | Left offset of the embedded control when ControlPosition is tcpCustom. |
| ControlPosition | Position of the embedded control within the tile. |
| ControlTop | Top offset of the embedded control when ControlPosition is tcpCustom. |
| ControlWidth | Width of the embedded control in pixels; pass 0 to use the control's natural width. |
| DataBoolean | General-purpose Boolean for application use. |
| DataInteger | General-purpose integer for application use. |
| DataObject | General-purpose object reference for application use. |
| DataString | General-purpose string for application use. |
| Description | Secondary descriptive text shown below the title; supports HTML formatting. |
| Empty | When True, the tile is an invisible placeholder that occupies grid space without displaying content. |
| Enabled | When False, the tile is grayed out and cannot be selected or clicked. |
| Hint | Tooltip text shown when the mouse hovers over the tile. |
| HorizontalDescriptionAlign | Horizontal alignment of the description text within the description area. |
| HorizontalTitleAlign | Horizontal alignment of the title text within the title area. |
| Image | Bitmap image displayed on the tile according to ImagePosition. |
| ImageHeight | Height of the image in pixels; pass 0 to use the natural bitmap height. |
| ImageLeft | Left offset of the image when ImagePosition is tipCustom. |
| ImageName | Name of the bitmap in the bitmap container used as the tile image. |
| ImagePosition | Position of the tile image relative to the title and description text. |
| ImageTop | Top offset of the image when ImagePosition is tipCustom. |
| ImageWidth | Width of the image in pixels; pass 0 to use the natural bitmap width. |
| Margins | Outer margins between the tile boundary and its background drawing area. |
| RowSpan | Number of grid rows this tile occupies. |
| Selected | When True, the tile is currently selected. |
| Title | Primary label text shown on the tile; supports HTML formatting. |
| TitleHeight | Height of the title text area in pixels; pass 0 to use the auto-calculated height. |
| VerticalDescriptionAlign | Vertical alignment of the description text within the description area. |
| VerticalTitleAlign | Vertical alignment of the title text within the title area. |
| Visible | When False, the tile is hidden and its grid space is freed. |
| Visualizer | Optional visualizer component that overrides the default tile drawing and mouse handling. |
Methods
| Name | Description |
|---|---|
| AllowDisplay | Returns True when the tile is visible and not an empty placeholder. |
| State | Returns the current visual interaction state of the tile. |