System.Windows.Forms.TabPage Class

Represents a single tab page in a System.Windows.Forms.TabControl.

See Also: TabPage Members

Syntax

[System.ComponentModel.ToolboxItem(false)]
[System.ComponentModel.Designer("System.Windows.Forms.Design.TabPageDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")]
[System.ComponentModel.DefaultProperty("Text")]
[System.ComponentModel.DesignTimeVisible(false)]
[System.ComponentModel.DefaultEvent("Click")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class TabPage : Panel

Remarks

System.Windows.Forms.TabPage controls represent the tabbed pages in a System.Windows.Forms.TabControl control. The order of tab pages in the TabControl.TabPages collection reflects the order of tabs in the System.Windows.Forms.TabControl control. To change the order of tabs in the control, you must change their positions in the collection by removing them and inserting them at new indexes.

System.Windows.Forms.TabPage controls are constrained by their container, so some of the properties inherited from the System.Windows.Forms.Control base class will have no effect, including Control.Top, Control.Height, Control.Left, Control.Width, Control.Show, and Control.Hide.

The tabs in a System.Windows.Forms.TabControl are part of the System.Windows.Forms.TabControl but not parts of the individual System.Windows.Forms.TabPage controls. Members of the System.Windows.Forms.TabPage class, such as the Control.ForeColor property, affect only the client rectangle of the tab page, but not the tabs. Additionally, the Control.Hide method of the System.Windows.Forms.TabPage will not hide the tab. To hide the tab, you must remove the System.Windows.Forms.TabPage control from the TabControl.TabPages collection.

Note:

In dnprdnext, the tab is considered part of the tab page for determining when the Control.Enter and Control.Leave events of the System.Windows.Forms.TabPage occur. In earlier versions of the .NET Framework, the Control.Enter and Control.Leave events of the System.Windows.Forms.TabPage do not occur when focus enters or leaves a tab, but only when focus enters or leaves the client rectangle of the tab page.

For more information about how this control responds to the Control.Focus and Control.Select methods, see the following System.Windows.Forms.Control members: Control.CanFocus, Control.CanSelect, Control.Focused, Control.ContainsFocus, Control.Focus, Control.Select.

Note:

Controls contained in a System.Windows.Forms.TabPage are not created until the tab page is shown, and any data bindings in these controls are not activated until the tab page is shown.

In dnprdnext, the TabPage.UseVisualStyleBackColor property lets you indicate whether the background of the tab page should render using the current visual style. This occurs only when the TabPage.UseVisualStyleBackColor and Application.RenderWithVisualStyles property values are both true and the TabControl.Appearance property of the parent System.Windows.Forms.TabControl is TabAppearance.Normal. Otherwise, the background is painted normally.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0