TdxCustomTileControl.CreateItem(TdxTileControlItemSize,TdxTileControlGroup) Method

Creates a new tile item.

Declaration

function CreateItem(ASize: TdxTileControlItemSize; AGroup: TdxTileControlGroup = nil): TdxTileControlItem; overload;

Parameters

Name	Type
ASize	TdxTileControlItemSize
AGroup	TdxTileControlGroup

Returns

Type
TdxTileControlItem

Remarks

This function returns a new tile item added to the Items collection.

The first overloaded variant is deprecated, and is retained for backward compatibility only. Use the second overloaded variant instead.

The ASize parameter specifies one of the predefined size values of the created tile item, initializing its Size property.

The optional AGroup parameter allows you to specify one of the existing tile groups to which the newly created tile item is linked. By default, if nil is passed as the AGroup parameter, the CreateItem function links the created tile item to the last visible group in the Groups collection. If there are no visible groups in the tile control, a new group is created as a container for the newly created tile. To identify a group to which the tile is linked, use its Group property.

Note

You can pass a hidden group as the AGroup parameter. The resulting tile item is invisible, like any other tile linked to a hidden group.