Vcl.ComCtrls.TCustomListView.TileColumns
Delphi
property TileColumns: TTileColumns read FTileColumns write SetTileColumns stored StoreTileColumns;
C++
__property TTileColumns* TileColumns = {read=FTileColumns, write=SetTileColumns, stored=StoreTileColumns};
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| property | protected | Vcl.ComCtrls.pas Vcl.ComCtrls.hpp |
Vcl.ComCtrls | TCustomListView |
Description
TileColumns property of the control automatically adjusts tile info for all existing items in the list. Besides, adjusting additional lines inside the item to show the sub-item text from columns.
Warning: Runtime Themes must be enabled for Tile View support in TListView to work.
Requirements
Before adjusting the tile info for items consider the following requirements:
- The controls need to have columns added first.
- The code checks the count of columns when it updates the resulting array from the TileColumns property.
- The TileColumns Item has an Order property (the order number of the column with sub item, which should be more than 0)
- The TileOptions.SubLineCount should be more than 0.
Tip: If the Item.Caption value is empty and an item has sub-items, when you set tile info you will get an Access Violation error. As a workaround, check the Item.Caption in the additional code of the library and set or clear the tile info for the item.