Version

ShowStateChangeButton Property (UltraTileSettings)

Gets or sets the value indicating whether the state change button should appear in the header area.
Syntax
'Declaration
 
Public Property ShowStateChangeButton As Infragistics.Win.DefaultableBoolean
public Infragistics.Win.DefaultableBoolean ShowStateChangeButton {get; set;}

Property Value

True if the state change button should be display; False if it should be hidden.
Exceptions
ExceptionDescription
System.ComponentModel.InvalidEnumArgumentExceptionThe value assigned is not a member of the Infragistics.Win.DefaultableBoolean enumeration.
Remarks

The state change button will have different effects on the UltraTile depenging on its current State. When the tile is in the Normal state, the state change button will place the tile in the Large state. If the tile is in the Large state, pressing the state change button will put all tiles in the Normal state.

If putting an UltraTile in the Large state will put the number of Large tiles in the UltraTilePanel over the UltraTilePanel.MaximumVisibleLargeTilesResolved value, the earliest tile to be placeed in the Large state will be placed in the Normal state.

Example
The following code demonstrates how to control various appearances and settings on an UltraTile.

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)

' Set the border style and color of the tile.
tile.Settings.Appearance.BorderColor = Color.Red
tile.Settings.BorderStyle = Infragistics.Win.UIElementBorderStyle.Solid

' Show the close button and made the X in the button red or yellow depending on whether 
' or not the mouse is over the button.
tile.Settings.ShowCloseButton = Infragistics.Win.DefaultableBoolean.True
tile.Settings.CloseButtonAppearance.ForeColor = Color.Red
tile.Settings.CloseButtonHotTrackAppearance.ForeColor = Color.Yellow

' Change the appearance of the tile header.
tile.Settings.HeaderAppearance.BackColor = Color.RoyalBlue

'Set the height of the heade rin the tile to 50 pixels.
tile.Settings.HeaderExtent = 50

' Don't allow the UltraTile to be larger than 150 in each dimension.
tile.Settings.MaximumSize = New Size(150, 150)

' Hide the state change button on the UltraTile.
tile.Settings.ShowStateChangeButton = Infragistics.Win.DefaultableBoolean.False

' Don't show a shadow around the UltraTile.
tile.Settings.ShowTileShadow = Infragistics.Win.DefaultableBoolean.False


' Get the second tile in the UltraTilePanel
tile = Me.UltraTilePanel1.Tiles(1)

' Hide the header from the UltraTile
tile.Settings.HeaderPosition = TileHeaderPosition.Hidden


' Get the third tile in the UltraTilePanel
tile = Me.UltraTilePanel1.Tiles(2)

' Set the appearance of the state change button when the UltraTile is in the Large state.
tile.Settings.StateChangeButtonLargeAppearance.BackColor = Color.Black
tile.Settings.StateChangeButtonLargeAppearance.ForeColor = Color.White
tile.Settings.StateChangeButtonLargeHotTrackAppearance.ForeColor = Color.Red

' Set the appearance of the state change button when the UltraTile is in the Normal state.
tile.Settings.StateChangeButtonNormalAppearance.ForeColor = Color.Turquoise
tile.Settings.StateChangeButtonNormalHotTrackAppearance.ForeColor = Color.SlateBlue
using System.Windows.Forms;
using Infragistics.Win;
using Infragistics.Win.Misc;

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

// Set the border style and color of the tile.
tile.Settings.Appearance.BorderColor = Color.Red;
tile.Settings.BorderStyle = Infragistics.Win.UIElementBorderStyle.Solid;

// Show the close button and made the X in the button red or yellow depending on whether 
// or not the mouse is over the button.
tile.Settings.ShowCloseButton = Infragistics.Win.DefaultableBoolean.True;
tile.Settings.CloseButtonAppearance.ForeColor = Color.Red;
tile.Settings.CloseButtonHotTrackAppearance.ForeColor = Color.Yellow;

// Change the appearance of the tile header.
tile.Settings.HeaderAppearance.BackColor = Color.RoyalBlue;

//Set the height of the heade rin the tile to 50 pixels.
tile.Settings.HeaderExtent = 50;

// Don't allow the UltraTile to be larger than 150 in each dimension.
tile.Settings.MaximumSize = new Size( 150, 150 );

// Hide the state change button on the UltraTile.
tile.Settings.ShowStateChangeButton = Infragistics.Win.DefaultableBoolean.False;

// Don't show a shadow around the UltraTile.
tile.Settings.ShowTileShadow = Infragistics.Win.DefaultableBoolean.False;


// Get the second tile in the UltraTilePanel
tile = this.ultraTilePanel1.Tiles[ 1 ];

// Hide the header from the UltraTile
tile.Settings.HeaderPosition = TileHeaderPosition.Hidden;


// Get the third tile in the UltraTilePanel
tile = this.ultraTilePanel1.Tiles[ 2 ];

// Set the appearance of the state change button when the UltraTile is in the Large state.
tile.Settings.StateChangeButtonLargeAppearance.BackColor = Color.Black;
tile.Settings.StateChangeButtonLargeAppearance.ForeColor = Color.White;
tile.Settings.StateChangeButtonLargeHotTrackAppearance.ForeColor = Color.Red;

// Set the appearance of the state change button when the UltraTile is in the Normal state.
tile.Settings.StateChangeButtonNormalAppearance.ForeColor = Color.Turquoise;
tile.Settings.StateChangeButtonNormalHotTrackAppearance.ForeColor = Color.SlateBlue;
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

See Also