State Property (UltraTile)

Gets or sets the state of the UltraTile.

Syntax

Visual Basic

'Declaration
 
Public Property State As TileState

C#

public TileState State {get; set;}

Property Value

The state of the tile.

Exceptions

Exception	Description
System.ComponentModel.InvalidEnumArgumentException	The value assigned is not a member of the TileState enumeration.

Remarks

When all visible UltraTiles in an UltraTilePanel are in the Normal state, all tiles will be the same size and will be arranged in a grid. They can be repositioned by the user as well.

If one or more visible UltraTiles are in the Large state, they will occupy the majority of the UltraTilePanel while the remaining Normal state tiles will occupy a smaller portion of the panel on one of the sides.

Example

The following code demonstrates how to change the state of an UltraTile in code.

Visual Basic

Imports System.Windows.Forms
Imports Infragistics.Win
Imports Infragistics.Win.Misc

' Get the first tile in the UltraTilePanel
Dim tile As UltraTile = Me.UltraTilePanel1.Tiles(0)

' If the first tile is not in the Large state, animte it changing to the Large state.
If Not tile.State = TileState.Large Then
    tile.SetState(TileState.Large, True)
End If

C#

using System.Windows.Forms;
using Infragistics.Win;
using Infragistics.Win.Misc;

// Get the first tile in the UltraTilePanel
UltraTile tile = this.ultraTilePanel1.Tiles[ 0 ];

// If the first tile is not in the Large state, animte it changing to the Large state.
if ( tile.State != TileState.Large )
	tile.SetState( TileState.Large, true );

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2