New to Telerik UI for WinForms? Start a free 30-day trial

Hosts the content for a tab and stores tab presentation data such as its image and tooltip.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class TabPanel : ContainerControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, INotifyPropertyChanged

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlTabPanel...

Derived Classes: DockWindow

Implements: IBindableComponentIComponentIContainerControlIDisposableIDropTargetINotifyPropertyChangedISynchronizeInvokeIWin32Window...

Constructors

Initializes a tab content panel with double-buffered, user-painted, and transparent-background styles.

C#
public TabPanel()

Properties

Gets or sets the panel border style and refreshes the native window styles when it changes.

C#
public BorderStyle BorderStyle { get; set; }
Exceptions: InvalidEnumArgumentException

The value is not a supported BorderStyle.

Gets the initial size used when the panel is created.

C#
protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Gets or sets the Image associated with the panel.

C#
public Image Image { get; set; }

Gets or sets the SvgImage associated with the panel.

C#
public RadSvgImage SvgImage { get; set; }

Gets the tab-strip panel that directly contains this panel, or null when it has no such parent.

C#
[Browsable(false)]
public TabStripPanel TabStrip { get; }

Gets or sets the tab item associated with this panel. Replacing it removes and disposes the previous item, and applies this panel's current tooltip to the new item.

C#
[Browsable(false)]
public TabStripItem TabStripItem { get; set; }

Gets or sets the tooltip to be displayed when the mouse hovers the tabitem of this panel.

C#
public string ToolTipText { get; set; }

Methods

Gets the direct parent tab-strip panel when it is assignable to T.

C#
public T GetTabStrip<T>() where T : TabStripPanel
Returns:

T

The parent tab-strip panel cast to T, or null if it is not of that type.

Notifies for a change in the Image and SvgImage members of this panel.

C#
protected virtual void OnImageChanged(EventArgs e)
Parameters:eEventArgs

Raises PropertyChanged with the name of the changed property.

C#
protected virtual void OnPropertyChanged(string propertyName)
Parameters:propertyNamestring

The name of the property that changed.

Updates the associated tab item's tooltip after this panel's tooltip changes.

C#
protected virtual void OnToolTipTextChanged(EventArgs e)
Parameters:eEventArgs

Event data for the tooltip change.

Events

Occurs when a derived panel reports a property change through OnPropertyChanged(string).

C#
public event PropertyChangedEventHandler PropertyChanged

Implements: INotifyPropertyChanged.PropertyChanged

C#
[Browsable(true)]
public event EventHandler TextChanged