TileControl Class

The control that manages Windows UI-inspired tiles. Using this component, you can create both static and animated live tiles in your applications.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v18.1.dll

Declaration

C#

[Docking(DockingBehavior.Ask)]
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "TileControl")]
[ToolboxTabName("DX.18.1: Navigation & Layout")]
public class TileControl :
    Control,
    ITileControl,
    ITileControlUpdateSmartTag,
    ITileControlProperties,
    ISupportXtraAnimation,
    ISupportLookAndFeel,
    IAppearanceOwner,
    IXtraSerializable,
    IMouseWheelScrollClient,
    IMouseWheelSupport,
    IToolTipControlClient,
    IContextItemCollectionOptionsOwner,
    IContextItemCollectionOwner,
    ISupportAccessibilityNotifyClients,
    ISupportDesignerRegistration,
    ISupportPageNavigation,
    IDirectXClient,
    ISupportAsyncScrollAnimation

VB.NET

<ToolboxBitmap(GetType(ToolboxIconsRootNS), "TileControl")>
<ToolboxTabName("DX.18.1: Navigation & Layout")>
<Docking(DockingBehavior.Ask)>
Public Class TileControl
    Inherits Control
    Implements ITileControl,
               ITileControlUpdateSmartTag,
               ITileControlProperties,
               ISupportXtraAnimation,
               ISupportLookAndFeel,
               IAppearanceOwner,
               IXtraSerializable,
               IMouseWheelScrollClient,
               IMouseWheelSupport,
               IToolTipControlClient,
               IContextItemCollectionOptionsOwner,
               IContextItemCollectionOwner,
               ISupportAccessibilityNotifyClients,
               ISupportDesignerRegistration,
               ISupportPageNavigation,
               IDirectXClient,
               ISupportAsyncScrollAnimation

Remarks

The Tile Control, inspired by the Windows 10 UI from Microsoft, helps you easily integrate live tiles into your applications. See the Tile Control topic to learn more.

TileControl consists of two main visual elements - TileGroups and TileItems. Refer to the Tile Groups and Items topic for more info.

The following code illustrates how to create a Tile Control at runtime. The control has one group with one Tile inside.

C#

//Form1.cs
TileControl tileControl = new TileControl { Dock = DockStyle.Fill, Parent = this };
TileGroup tileGroup = new TileGroup();
TileItem tileItem = new TileItem();
TileItemElement tileItemElement = new TileItemElement { Text = "Some text" };
tileItem.Elements.Add(tileItemElement);
tileGroup.Items.Add(tileItem);
tileControl.Groups.Add(tileGroup);

VB.NET

'Form1.vb
Dim tileControl As TileControl = New TileControl With {.Dock = DockStyle.Fill, .Parent = Me}
Dim tileGroup As New TileGroup()
Dim tileItem As New TileItem()
Dim tileItemElement As TileItemElement = New TileItemElement With {.Text = "Some text"}
tileItem.Elements.Add(tileItemElement)
tileGroup.Items.Add(tileItem)
tileControl.Groups.Add(tileGroup)

Pager Navigation

The RadioGroup and WindowsUIButtonPanel can be used as a pager for the following controls:

• TileControl
• TileBar
• NavigationFrame
• ImageSlider

The pager automatically splits the target control’s content into pages, and provides navigation buttons to scroll to corresponding pages. The pager navigation functionality is implemented as a Behavior and can be added to your controls using the BehaviorManager component.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the TileControl class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-suppress-tilecontrol-default-navigation-logic-and-obtain-esc-key-down-e4416/CS/MyTileControl.cs#L30

namespace TileControlSample {
    public class MyTileControl : TileControl {
        public MyTileControl() {

how-to-use-searchcontrol-for-tilecontrol-t273248/CS/CustomTileControl.cs#L12

namespace dxExample {
    public class CustomTileControl : TileControl, ISearchControlClient {
        public CustomTileControl() {

VB.NET

how-to-suppress-tilecontrol-default-navigation-logic-and-obtain-esc-key-down-e4416/VB/MyTileControl.vb#L33

Public Class MyTileControl
    Inherits TileControl
    Public Sub New()

how-to-use-searchcontrol-for-tilecontrol-t273248/VB/CustomTileControl.vb#L14

Public Class CustomTileControl
    Inherits TileControl
    Implements ISearchControlClient

Inheritance

Object

MarshalByRefObject

Component

Control

TileControl

TileBar