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

Gets or sets the location of close buttons within the control.

Syntax

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

Exceptions

ExceptionDescription
InvalidEnumArgumentException The value assigned is not defined in the TabCloseButtonLocation enumeration.

Remarks

Setting this property to None will prevent a middle mouse button click from closing a 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