Skip to main content

TileItemElement Class

Provides the base class for creating and using tile item elements.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

public class TileItemElement :
    ICloneable,
    IAppearanceOwner,
    IAnimatedItem,
    ISupportXtraAnimation,
    IDXImageUriClient

The following members return TileItemElement objects:

Remarks

TileItemElements are used to build TileItems content. This works both for static and animated tile items. In both cases, use the Elements property to access a collection of elements (type of TileItemElementCollection) that specify the parent item’s content - the TileItem.Elements property for static tiles and the TileItemFrame.Elements property for each of animated tile’s frames. You can use as many elements as you need within a single tile (frame) to build a desired content.

Every element is a block that can contain text (the TileItemElement.Text property) and a glyph (the TileItemElement.Image property). A glyph and text can be arranged independently of each other. Elements’ text strings can be formatted using HTML tags if the TileItem.AllowHtmlText is set to true. A Glyphs’ display mode can be customized via the TileItemElement.ImageScaleMode property. Moreover, a glyph can be grouped with text via the TileItemElement.ImageToTextAlignment property. In this case, the TileItemElement.TextAlignment property is ignored and the group is placed according to the TileItemElement.ImageAlignment property value.

The TileItemElement.Text and TileItemElement.Image properties for the Elements collection’s first element can be accessed directly through a tile item via the TileItem.Text and TileItem.Image properties.

See the Tile Item Structure topic to learn more.

Inheritance

See Also