Infragistics2.Win.UltraWinTabControl.v8.1
TabCloseButtonAlignment Property
See Also  Example
Infragistics.Win.UltraWinTabControl Namespace > UltraTabControlBase Class : TabCloseButtonAlignment Property

Gets or sets the default alignment of the close button within the tab.

Syntax

Visual Basic (Declaration) 
Public Property TabCloseButtonAlignment As TabCloseButtonAlignment
C# 
public TabCloseButtonAlignment TabCloseButtonAlignment {get; set;}

Exceptions

ExceptionDescription
InvalidEnumArgumentException The value assigned is not defined in the T:TabCloseButtonAlignment enumeration.

Remarks

This only applies if the UltraTabControlBase.CloseButtonLocation is set to Tab.

Example

The following code demonstrates how to control the behavior of a close button within a tab at a tab control level.

Visual BasicCopy Code
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs

' Place close buttons in all the tabs of the tab control.
Me.UltraTabControl1.CloseButtonLocation = TabCloseButtonLocation.Tab

' The close button in all tabs should be disabled as well as the ability to middle click and close the tab
' unless that tab has overriden the setting by having a non-default AllowClosing.
Me.UltraTabControl1.AllowTabClosing = False

' The close button in all tabs should come before the image and text of the tab
' unless that tab has overriden the setting by having a non-default CloseButtonAlignment.
Me.UltraTabControl1.TabCloseButtonAlignment = TabCloseButtonAlignment.BeforeContent

' All tabs should only display the clos ebutton when they are selected or when the mouse is over them
' unless that tab has overriden the setting by having a non-default CloseButtonVisibility.
' For the close button to show when the tab is hot tracked, UseHotTracking must be True.
Me.UltraTabControl1.TabCloseButtonVisibility = TabCloseButtonVisibility.WhenSelectedOrHotTracked
Me.UltraTabControl1.UseHotTracking = DefaultableBoolean.True
C#Copy Code
using System.Windows.Forms;
using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;

// Place close buttons in all the tabs of the tab control.
this.ultraTabControl1.CloseButtonLocation = TabCloseButtonLocation.Tab;

// The close button in all tabs should be disabled as well as the ability to middle click and close the tab
// unless that tab has overriden the setting by having a non-default AllowClosing.
this.ultraTabControl1.AllowTabClosing = false;

// The close button in all tabs should come before the image and text of the tab
// unless that tab has overriden the setting by having a non-default CloseButtonAlignment.
this.ultraTabControl1.TabCloseButtonAlignment = TabCloseButtonAlignment.BeforeContent;

// All tabs should only display the clos ebutton when they are selected or when the mouse is over them
// unless that tab has overriden the setting by having a non-default CloseButtonVisibility.
// For the close button to show when the tab is hot tracked, UseHotTracking must be True.
this.ultraTabControl1.TabCloseButtonVisibility = TabCloseButtonVisibility.WhenSelectedOrHotTracked;
this.ultraTabControl1.UseHotTracking = DefaultableBoolean.True;

See Also