TabPage 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示 TabControl 中的单个选项卡页。
public ref class TabPage : System::Windows::Forms::Panel
public 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.Panel
type TabPage = class
inherit Panel
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TabPage = class
inherit Panel
Public Class TabPage
Inherits Panel
- 继承
- 属性
示例
下面的代码示例使用一个 TabControl 创建 。TabPage
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、LeftWidth、 Show和 Hide。
中的 TabControl 选项卡是 的一部分, TabControl 但不是各个 TabPage 控件的一部分。 类的成员 TabPage (如 ForeColor 属性)仅影响选项卡页的客户端矩形,而不会影响选项卡。 此外, Hide 的 TabPage 方法不会隐藏选项卡。若要隐藏选项卡,必须从TabControl.TabPages集合中删除控件TabPage。
注意
在 .NET Framework 2.0 中,选项卡被视为选项卡页的一部分,用于确定 何时Enter发生 和 LeaveTabPage 事件。 在早期版本的 .NET Framework 中, Enter 的 TabPage 和 Leave 事件不会在焦点进入或离开选项卡时发生,而仅在焦点进入或离开选项卡页的客户端矩形时发生。
有关此控件如何响应 Focus 和 Select 方法的详细信息,请参阅以下Control成员:CanFocus、、CanSelect、Focused、ContainsFocus、Focus。 Select
注意
在显示选项卡页之前,不会创建 中包含的 TabPage 控件,并且这些控件中的任何数据绑定在显示选项卡页之前不会激活。
在 .NET Framework 2.0 中, UseVisualStyleBackColor 属性允许您指示选项卡页的背景是否应使用当前视觉样式呈现。 仅当 和 Application.RenderWithVisualStyles 属性值均为 true
且Appearance父TabControl级的 属性为 Normal时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 |
此属性对于此控件无意义。 |
AutoSize |
获取或设置一个值,该值指示控件是否基于其内容调整大小。 (继承自 Panel) |
AutoSizeMode |
此属性对于此控件无意义。 |
AutoSizeMode |
指示控件的自动调整大小行为。 (继承自 Panel) |
BackColor |
获取或设置 TabPage 的背景色。 |
BackColor |
获取或设置控件的背景色。 (继承自 Control) |
BackgroundImage |
获取或设置在控件中显示的背景图像。 (继承自 Control) |
BackgroundImageLayout |
获取或设置在 ImageLayout 枚举中定义的背景图像布局。 (继承自 Control) |
BindingContext |
获取或设置控件的 BindingContext。 (继承自 Control) |
BorderStyle |
指示控件的边框样式。 (继承自 Panel) |
Bottom |
获取控件下边缘与其容器的工作区上边缘之间的距离(以像素为单位)。 (继承自 Control) |
Bounds |
获取或设置控件(包括其非工作区元素)相对于其父控件的大小和位置(以像素为单位)。 (继承自 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 |
获取创建控件句柄时所需要的创建参数。 (继承自 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 |
获取或设置关联 ImageList 的 TabControl 中的图像的键访问器。 |
ImeMode |
获取或设置控件的输入法编辑器 (IME) 模式。 (继承自 Control) |
ImeModeBase |
获取或设置控件的 IME 模式。 (继承自 Control) |
InvokeRequired |
获取一个值,该值指示调用方在对控件进行方法调用时是否必须调用 Invoke 方法,因为调用方位于创建控件所在的线程以外的线程中。 (继承自 Control) |
IsAccessible |
获取或设置一个值,该值指示控件对辅助功能应用程序是否可见。 (继承自 Control) |
IsAncestorSiteInDesignMode |
指示此控件的上级之一是否位于 DesignMode 中。 此属性为只读。 (继承自 Control) |
IsDisposed |
获取一个值,该值指示控件是否已经被释放。 (继承自 Control) |
IsHandleCreated |
获取一个值,该值指示控件是否有与它关联的句柄。 (继承自 Control) |
IsMirrored |
获取一个值,该值指示此控件是否为镜像控件。 (继承自 Control) |
LayoutEngine |
获取控件的布局引擎的缓存实例。 (继承自 Control) |
Left |
获取或设置控件左边缘与其容器的工作区左边缘之间的距离(以像素为单位)。 (继承自 Control) |
Location |
此属性对于此控件无意义。 |
Location |
获取或设置该控件的左上角相对于其容器的左上角的坐标。 (继承自 Control) |
Margin |
获取或设置控件之间的空间。 (继承自 Control) |
MaximumSize |
此属性对于此控件无意义。 |
MaximumSize |
获取或设置大小,该大小是 GetPreferredSize(Size) 可以指定的上限。 (继承自 Control) |
MinimumSize |
此属性对于此控件无意义。 |
MinimumSize |
获取或设置大小,该大小是 GetPreferredSize(Size) 可以指定的下限。 (继承自 Control) |
Name |
获取或设置控件的名称。 (继承自 Control) |
Padding |
获取或设置控件内的空白。 (继承自 Control) |
Parent |
获取或设置控件的父容器。 (继承自 Control) |
PreferredSize |
此属性对于此控件无意义。 |
PreferredSize |
获取可以容纳控件的矩形区域的大小。 (继承自 Control) |
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) |