Version

HeaderExtent Property (UltraTileSettings)

Gets or sets the extent of the header in the UltraTile.
Syntax
'Declaration
 
Public Property HeaderExtent As Integer
public int HeaderExtent {get; set;}

Property Value

The extent of the header in the UltraTile; zero if it is the default extent.
Exceptions
ExceptionDescription
System.ArgumentOutOfRangeException The value assigned is less then 0.
Remarks

If the header is shown on the top or bottom of the UltraTile, this value indicates the height of the header. If the header is shown on the left or right of the UltraTIle, this value indicates the width of the header. If the header is hidden, this value is ignored.

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