Panel 类
用于对控件集合进行分组。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class Panel
Inherits ScrollableControl
用法
Dim instance As Panel
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
public class Panel : ScrollableControl
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[ComVisibleAttribute(true)]
public ref class Panel : public ScrollableControl
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute ComVisibleAttribute(true) */
public class Panel extends ScrollableControl
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)
ComVisibleAttribute(true)
public class Panel extends ScrollableControl
备注
Panel 是一个包含其他控件的控件。可以使用 Panel 来组合控件的集合，例如一组 RadioButton 控件。与其他容器控件（如 GroupBox 控件）一样，如果 Panel 控件的 Enabled 属性设置为 false，则也会禁用包含在 Panel 中的控件。
默认情况下，Panel 控件在显示时没有任何边框。可以用 BorderStyle 属性提供标准或三维的边框，将窗面板区与窗体上的其他区域区分开。因为 Panel 控件派生于 ScrollableControl 类，所以可以用 AutoScroll 属性来启用 Panel 控件中的滚动条。当 AutoScroll 属性设置为 true 时，使用所提供的滚动条可以滚动显示 Panel 中（但不在其可视区域内）的所有控件。
Panel 控件不显示标题。如果需要与 Panel 类似可显示标题的控件，请参见 GroupBox 控件。
示例
下面的代码示例创建一个 Panel 控件，并向 Panel 添加一个 Label 和一个 TextBox。Panel 控件显示有三维边框，以将 Panel 控件所在的区域与窗体上其他的对象区分开。此示例需要它所定义的方法是从现有窗体中调用的，并且已将 System.Drawing 命名空间添加到该窗体的源代码中。
Public Sub CreateMyPanel()
Dim panel1 As New Panel()
Dim textBox1 As New TextBox()
Dim label1 As New Label()
' Initialize the Panel control.
panel1.Location = New Point(56, 72)
panel1.Size = New Size(264, 152)
' Set the Borderstyle for the Panel to three-dimensional.
panel1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D
' Initialize the Label and TextBox controls.
label1.Location = New Point(16, 16)
label1.Text = "label1"
label1.Size = New Size(104, 16)
textBox1.Location = New Point(16, 32)
textBox1.Text = ""
textBox1.Size = New Size(152, 20)
' Add the Panel control to the form.
Me.Controls.Add(panel1)
' Add the Label and TextBox controls to the Panel.
panel1.Controls.Add(label1)
panel1.Controls.Add(textBox1)
End Sub
public void CreateMyPanel()
{
Panel panel1 = new Panel();
TextBox textBox1 = new TextBox();
Label label1 = new Label();
// Initialize the Panel control.
panel1.Location = new Point(56,72);
panel1.Size = new Size(264, 152);
// Set the Borderstyle for the Panel to three-dimensional.
panel1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
// Initialize the Label and TextBox controls.
label1.Location = new Point(16,16);
label1.Text = "label1";
label1.Size = new Size(104, 16);
textBox1.Location = new Point(16,32);
textBox1.Text = "";
textBox1.Size = new Size(152, 20);
// Add the Panel control to the form.
this.Controls.Add(panel1);
// Add the Label and TextBox controls to the Panel.
panel1.Controls.Add(label1);
panel1.Controls.Add(textBox1);
}
public:
void CreateMyPanel()
{
Panel^ panel1 = gcnew Panel;
TextBox^ textBox1 = gcnew TextBox;
Label^ label1 = gcnew Label;
// Initialize the Panel control.
panel1->Location = System::Drawing::Point( 56, 72 );
panel1->Size = System::Drawing::Size( 264, 152 );
// Set the Borderstyle for the Panel to three-dimensional.
panel1->BorderStyle = System::Windows::Forms::BorderStyle::Fixed3D;
// Initialize the Label and TextBox controls.
label1->Location = System::Drawing::Point( 16, 16 );
label1->Text = "label1";
label1->Size = System::Drawing::Size( 104, 16 );
textBox1->Location = System::Drawing::Point( 16, 32 );
textBox1->Text = "";
textBox1->Size = System::Drawing::Size( 152, 20 );
// Add the Panel control to the form.
this->Controls->Add( panel1 );
// Add the Label and TextBox controls to the Panel.
panel1->Controls->Add( label1 );
panel1->Controls->Add( textBox1 );
}
public void CreateMyPanel()
{
Panel panel1 = new Panel();
TextBox textBox1 = new TextBox();
Label label1 = new Label();
// Initialize the Panel control.
panel1.set_Location(new Point(56, 72));
panel1.set_Size(new Size(264, 152));
// Set the Borderstyle for the Panel to three-dimensional.
panel1.set_BorderStyle(System.Windows.Forms.BorderStyle.Fixed3D);
// Initialize the Label and TextBox controls.
label1.set_Location(new Point(16, 16));
label1.set_Text("label1");
label1.set_Size(new Size(104, 16));
textBox1.set_Location(new Point(16, 32));
textBox1.set_Text("");
textBox1.set_Size(new Size(152, 20));
// Add the Panel control to the form.
this.get_Controls().Add(panel1);
// Add the Label and TextBox controls to the Panel.
panel1.get_Controls().Add(label1);
panel1.get_Controls().Add(textBox1);
} //CreateMyPanel
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.Panel
派生类
线程安全
此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0