TabPage 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个选项卡中的 TabControl单个选项卡页。
public ref class TabPage : System::Windows::Forms::Panelpublic class TabPage : System.Windows.Forms.Panel[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class TabPage : System.Windows.Forms.Paneltype TabPage = class
inherit Panel[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TabPage = class
inherit PanelPublic Class TabPage
Inherits Panel- 继承
- 属性
示例
下面的代码示例创建一个包含一个 TabControlTabPage。
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
TabControl^ tabControl1;
// Declares tabPage1 as a TabPage type.
System::Windows::Forms::TabPage^ tabPage1;
void MyTabs()
{
this->tabControl1 = gcnew TabControl;
// Invokes the TabPage() constructor to create the tabPage1.
this->tabPage1 = gcnew System::Windows::Forms::TabPage;
array<Control^>^tabControls = {this->tabPage1};
this->tabControl1->Controls->AddRange( tabControls );
this->tabControl1->Location = Point(25,25);
this->tabControl1->Size = System::Drawing::Size( 250, 250 );
this->ClientSize = System::Drawing::Size( 300, 300 );
array<Control^>^formControls = {this->tabControl1};
this->Controls->AddRange( formControls );
}
public:
Form1()
{
MyTabs();
}
};
int main()
{
Application::Run( gcnew Form1 );
}
using System.Drawing;
using System.Windows.Forms;
public class Form1 : Form
{
private TabControl tabControl1;
// Declares tabPage1 as a TabPage type.
private System.Windows.Forms.TabPage tabPage1;
private void MyTabs()
{
this.tabControl1 = new TabControl();
// Invokes the TabPage() constructor to create the tabPage1.
this.tabPage1 = new System.Windows.Forms.TabPage();
this.tabControl1.Controls.AddRange(new Control[] {
this.tabPage1});
this.tabControl1.Location = new Point(25, 25);
this.tabControl1.Size = new Size(250, 250);
this.ClientSize = new Size(300, 300);
this.Controls.AddRange(new Control[] {
this.tabControl1});
}
public Form1()
{
MyTabs();
}
static void Main()
{
Application.Run(new Form1());
}
}
Imports System.Drawing
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Private tabControl1 As TabControl
' Declares tabPage1 as a TabPage type.
Private tabPage1 As System.Windows.Forms.TabPage
Private Sub MyTabs()
Me.tabControl1 = New TabControl()
' Invokes the TabPage() constructor to create the tabPage1.
Me.tabPage1 = New System.Windows.Forms.TabPage()
Me.tabControl1.Controls.AddRange(New Control() {Me.tabPage1})
Me.tabControl1.Location = New Point(25, 25)
Me.tabControl1.Size = New Size(250, 250)
Me.ClientSize = New Size(300, 300)
Me.Controls.AddRange(New Control() {Me.tabControl1})
End Sub
Public Sub New()
MyTabs()
End Sub
Shared Sub Main()
Application.Run(New Form1())
End Sub
End Class
注解
TabPage 控件表示控件中的 TabControl 选项卡式页面。 集合中 TabControl.TabPages 选项卡页的顺序反映了控件中 TabControl 选项卡的顺序。 若要更改控件中选项卡的顺序，必须通过删除选项卡并将其插入到新索引来更改集合中的位置。
TabPage控件受其容器约束，因此继承自Control基类的某些属性将不起作用，包括Top、Height、Left、Width和ShowHide。
选项卡中 TabControl 是各个控件的 TabControl 一部分，但不是各个 TabPage 控件的一部分。 类的成员 TabPage （如 ForeColor 属性）仅影响选项卡页的客户端矩形，但不会影响选项卡。 此外，Hide该方法TabPage不会隐藏选项卡。若要隐藏选项卡，必须从TabControl.TabPages集合中删除TabPage控件。
有关此控件如何响应Focus和Select方法的详细信息，请参阅以下Control成员：CanFocus、、CanSelect、ContainsFocusFocused、Focus。 Select
注释
在显示选项卡页之前，不会创建包含在其中的 TabPage 控件，并且这些控件中的任何数据绑定在显示选项卡页之前不会激活。
该 UseVisualStyleBackColor 属性允许你指示选项卡页的背景是否应使用当前视觉样式呈现。 仅当和属性值均为NormalTabControltrueAppearance父Application.RenderWithVisualStyles级时UseVisualStyleBackColor，才会发生此情况。 否则，通常会绘制背景。
构造函数
| 名称 | 说明 |
|---|---|
| TabPage() |
初始化 TabPage 类的新实例。 |
| TabPage(String) |
初始化类的新实例 TabPage 并指定选项卡的文本。 |
字段
| 名称 | 说明 |
|---|---|
| ScrollStateAutoScrolling |
确定属性的值 AutoScroll 。 (继承自 ScrollableControl) |
| ScrollStateFullDrag |
确定用户是否已启用全屏拖动。 (继承自 ScrollableControl) |
| ScrollStateHScrollVisible |
确定属性的值 HScroll 是否设置为 |
| ScrollStateUserHasScrolled |
确定用户是否已滚动浏览控件 ScrollableControl 。 (继承自 ScrollableControl) |
| ScrollStateVScrollVisible |
确定属性的值 VScroll 是否设置为 |
属性
| 名称 | 说明 |
|---|---|
| AccessibilityObject |
AccessibleObject获取分配给控件的控件。 (继承自 Control) |
| AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明，以供辅助功能客户端应用程序使用。 (继承自 Control) |
| AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件的说明。 (继承自 Control) |
| AccessibleName |
获取或设置辅助功能客户端应用程序使用的控件的名称。 (继承自 Control) |
| AccessibleRole |
获取或设置控件的可访问角色。 (继承自 Control) |
| AllowDrop |
获取或设置一个值，该值指示控件是否可以接受用户拖动到其中的数据。 (继承自 Control) |
| Anchor |
此成员对此控件没有意义。 |
| AutoScroll |
获取或设置一个值，该值指示容器是否允许用户滚动到其可见边界之外的任何控件。 (继承自 ScrollableControl) |
| AutoScrollMargin |
获取或设置自动滚动边距的大小。 (继承自 ScrollableControl) |
| AutoScrollMinSize |
获取或设置自动滚动的最小大小。 (继承自 ScrollableControl) |
| AutoScrollOffset |
获取或设置此控件滚动到的位置 ScrollControlIntoView(Control)。 (继承自 Control) |
| AutoScrollPosition |
获取或设置自动滚动位置的位置。 (继承自 ScrollableControl) |
| AutoSize |
此属性对于此控件没有意义。 |
| AutoSizeMode |
此属性对于此控件没有意义。 |
| BackColor |
获取或设置 . TabPage. 的背景色。 |
| BackColor |
获取或设置控件的背景色。 (继承自 Control) |
| BackgroundImage |
获取或设置控件中显示的背景图像。 (继承自 Control) |
| BackgroundImageLayout |
获取或设置枚举中 ImageLayout 定义的背景图像布局。 (继承自 Control) |
| BindingContext |
获取或设置 BindingContext 控件。 (继承自 Control) |
| BorderStyle |
指示控件的边框样式。 (继承自 Panel) |
| Bottom |
获取控件的下边缘与其容器工作区的上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件的大小和位置，包括其相对于父控件的非client 元素（以像素为单位）。 (继承自 Control) |
| CanEnableIme |
获取一个值，该值指示属性是否可以 ImeMode 设置为活动值，以启用 IME 支持。 (继承自 Control) |
| CanFocus |
获取一个值，该值指示控件是否可以接收焦点。 (继承自 Control) |
| CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
| CanSelect |
获取一个值，该值指示是否可以选择控件。 (继承自 Control) |
| Capture |
获取或设置一个值，该值指示控件是否已捕获鼠标。 (继承自 Control) |
| CausesValidation |
获取或设置一个值，该值指示控件是否导致验证在收到焦点时需要验证的任何控件上执行。 (继承自 Control) |
| ClientRectangle |
获取表示控件工作区的矩形。 (继承自 Control) |
| ClientSize |
获取或设置控件工作区的高度和宽度。 (继承自 Control) |
| CompanyName |
获取包含控件的应用程序的公司或创建者的名称。 (继承自 Control) |
| Container |
IContainer获取包含 .Component (继承自 Component) |
| ContainsFocus |
获取一个值，该值指示控件或其子控件之一当前是否具有输入焦点。 (继承自 Control) |
| ContextMenu |
已过时.
获取或设置与控件关联的快捷菜单。 (继承自 Control) |
| ContextMenuStrip |
获取或设置 ContextMenuStrip 与此控件关联的值。 (继承自 Control) |
| Controls |
获取控件中包含的控件的集合。 (继承自 Control) |
| Created |
获取一个值，该值指示是否已创建控件。 (继承自 Control) |
| CreateParams |
表示一个选项卡中的 TabControl单个选项卡页。 |
| CreateParams |
获取创建控件句柄时所需的创建参数。 (继承自 Panel) |
| Cursor |
获取或设置鼠标指针位于控件上时显示的光标。 (继承自 Control) |
| DataBindings |
获取控件的数据绑定。 (继承自 Control) |
| DataContext |
获取或设置用于数据绑定的数据上下文。 这是一个环境属性。 (继承自 Control) |
| DefaultCursor |
获取或设置控件的默认游标。 (继承自 Control) |
| DefaultImeMode |
获取控件支持的默认输入法编辑器 （IME） 模式。 (继承自 Control) |
| DefaultMargin |
获取默认情况下在控件之间指定的空间（以像素为单位）。 (继承自 Control) |
| DefaultMaximumSize |
获取指定为控件的默认最大大小的长度和高度（以像素为单位）。 (继承自 Control) |
| DefaultMinimumSize |
获取指定为控件的默认最小大小的长度和高度（以像素为单位）。 (继承自 Control) |
| DefaultPadding |
获取控件内容的默认内部间距（以像素为单位）。 (继承自 Control) |
| DefaultSize |
获取控件的默认大小。 (继承自 Panel) |
| DesignMode |
获取一个值，该值指示当前是否 Component 处于设计模式。 (继承自 Component) |
| DeviceDpi |
获取当前显示控件的显示设备的 DPI 值。 (继承自 Control) |
| DisplayRectangle |
获取表示控件的虚拟显示区域的矩形。 (继承自 ScrollableControl) |
| Disposing |
获取一个值，该值指示基 Control 类是否正在处理。 (继承自 Control) |
| Dock |
此成员对此控件没有意义。 |
| DockPadding |
获取控件的所有边缘的停靠填充设置。 (继承自 ScrollableControl) |
| DoubleBuffered |
获取或设置一个值，该值指示此控件是否应使用辅助缓冲区重新绘制其表面以减少或防止闪烁。 (继承自 Control) |
| Enabled |
此成员对此控件没有意义。 |
| Events |
获取附加到此 Component对象的事件处理程序的列表。 (继承自 Component) |
| Focused |
获取一个值，该值指示控件是否具有输入焦点。 (继承自 Control) |
| Font |
获取或设置控件显示的文本的字体。 (继承自 Control) |
| FontHeight |
获取或设置控件字体的高度。 (继承自 Control) |
| ForeColor |
获取或设置控件的前景色。 (继承自 Control) |
| Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
| HasChildren |
获取一个值，该值指示控件是否包含一个或多个子控件。 (继承自 Control) |
| Height |
获取或设置控件的高度。 (继承自 Control) |
| HorizontalScroll |
获取与水平滚动条关联的特征。 (继承自 ScrollableControl) |
| HScroll |
获取或设置一个值，该值指示水平滚动条是否可见。 (继承自 ScrollableControl) |
| ImageIndex |
获取或设置此选项卡上显示的图像的索引。 |
| ImageKey |
获取或设置关联的TabControl图像ImageList的键访问器。 |
| ImeMode |
获取或设置控件的输入法编辑器 （IME） 模式。 (继承自 Control) |
| ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
| InvokeRequired |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用调用方法，因为调用方与创建控件的线程不同。 (继承自 Control) |
| IsAccessible |
获取或设置一个值，该值指示控件是否对辅助功能应用程序可见。 (继承自 Control) |
| IsAncestorSiteInDesignMode |
指示此控件的上级位置之一是否位于 DesignMode 中。 此属性为只读。 (继承自 Control) |
| IsDisposed |
获取一个值，该值指示控件是否已释放。 (继承自 Control) |
| IsHandleCreated |
获取一个值，该值指示控件是否具有与之关联的句柄。 (继承自 Control) |
| IsMirrored |
获取一个值，该值指示控件是否镜像。 (继承自 Control) |
| LayoutEngine |
获取控件布局引擎的缓存实例。 (继承自 Control) |
| Left |
获取或设置控件左边缘与其容器工作区的左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Location |
此属性对于此控件没有意义。 |
| Location |
获取或设置控件左上角相对于其容器左上角的坐标。 (继承自 Control) |
| Margin |
获取或设置控件之间的间距。 (继承自 Control) |
| MaximumSize |
此属性对于此控件没有意义。 |
| MinimumSize |
此属性对于此控件没有意义。 |
| Name |
获取或设置控件的名称。 (继承自 Control) |
| Padding |
获取或设置控件中的填充。 (继承自 Control) |
| Parent |
获取或设置控件的父容器。 (继承自 Control) |
| PreferredSize |
此属性对于此控件没有意义。 |
| ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
| ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
| RecreatingHandle |
获取一个值，该值指示控件当前是否正在重新创建其句柄。 (继承自 Control) |
| Region |
获取或设置与控件关联的窗口区域。 (继承自 Control) |
| RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
| ResizeRedraw |
获取或设置一个值，该值指示控件在调整大小时是否重新绘制自身。 (继承自 Control) |
| Right |
获取控件右边缘与其容器工作区的左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| RightToLeft |
获取或设置一个值，该值指示控件的元素是否对齐以支持使用从右到左字体的区域设置。 (继承自 Control) |
| ScaleChildren |
获取一个值，该值确定子控件的缩放。 (继承自 Control) |
| ShowFocusCues |
获取一个值，该值指示控件是否应显示焦点矩形。 (继承自 Control) |
| ShowKeyboardCues |
获取一个值，该值指示用户界面是否处于适当的状态以显示或隐藏键盘加速器。 (继承自 Control) |
| Site |
获取或设置控件的站点。 (继承自 Control) |
| Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
| TabIndex |
此属性对于此控件没有意义。 |
| TabStop |
此成员对此控件没有意义。 |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或设置要显示在选项卡上的文本。 |
| ToolTipText |
获取或设置此选项卡的工具提示文本。 |
| Top |
获取或设置控件上边缘与其容器工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopLevelControl |
获取其他 Windows 窗体控件未父控件的父控件。 通常，这是控件包含在的最外层 Form 。 (继承自 Control) |
| UseVisualStyleBackColor |
获取或设置一个值，该值指示启用视觉样式时背景是否 TabPage 使用当前视觉样式呈现。 |
| UseWaitCursor |
获取或设置一个值，该值指示是否对当前控件和所有子控件使用等待游标。 (继承自 Control) |
| VerticalScroll |
获取与垂直滚动条关联的特征。 (继承自 ScrollableControl) |
| Visible |
此成员对此控件没有意义。 |
| VScroll |
获取或设置一个值，该值指示垂直滚动条是否可见。 (继承自 ScrollableControl) |
| Width |
获取或设置控件的宽度。 (继承自 Control) |
| WindowTarget |
此属性与此类无关。 (继承自 Control) |
方法
活动
显式接口实现
| 名称 | 说明 |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引发 DragDrop 事件。 (继承自 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引发 DragEnter 事件。 (继承自 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引发 DragLeave 事件。 (继承自 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引发 DragOver 事件。 (继承自 Control) |
