Version

ShowCloseButton Property (UltraTileSettings)

Gets or sets the value indicating whether the close button should be shown the UltraTile.
Syntax
'Declaration
 
Public Property ShowCloseButton As Infragistics.Win.DefaultableBoolean
public Infragistics.Win.DefaultableBoolean ShowCloseButton {get; set;}

Property Value

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

Clicking the close button will hide the UltraTile and its Visible property will return False. The UltraTile can only be shown again by programmatically setting Visible back to True.

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