Panel-Klasse
Wird zum Gruppieren von Auflistungen von Steuerelementen verwendet.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class Panel
Inherits ScrollableControl
'Usage
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
Hinweise
Ein Panel ist ein Steuerelement, das andere Steuerelemente enthält. Mit Panel können Sie Auflistungen von Steuerelementen gruppieren, z. B. eine Gruppe von RadioButton-Steuerelementen. Wie bei anderen Containersteuerelementen, z. B. dem GroupBox-Steuerelement, werden die in Panel enthaltenen Steuerelemente ebenfalls deaktiviert, wenn die Enabled-Eigenschaft des Panel-Steuerelements auf false festgelegt ist.
Das Panel-Steuerelement wird in der Standardeinstellung ohne Rahmen angezeigt. Ein Standardrahmen oder dreidimensionaler Rahmen kann bereitgestellt werden, indem der Auswahlbereich mithilfe der BorderStyle-Eigenschaft von anderen Bereichen des Formulars abgehoben wird. Da das Panel-Steuerelement von der ScrollableControl-Klasse abgeleitet ist, können Sie mithilfe der AutoScroll-Eigenschaft Bildlaufleisten im Panel-Steuerelement aktivieren. Wenn die AutoScroll-Eigenschaft auf true festgelegt ist, können alle Steuerelemente, die sich in Panel befinden (jedoch außerhalb des sichtbaren Bereichs), mithilfe der bereitgestellten Bildlaufleisten angezeigt werden.
Für das Panel-Steuerelement wird keine Beschriftung angezeigt. Wenn Sie ein Steuerelement benötigen, dass einem Panel ähnelt, aber eine Beschriftung anzeigen kann, verwenden Sie das GroupBox-Steuerelement.
Beispiel
Im folgenden Codebeispiel wird ein Panel-Steuerelement erstellt sowie dem Panel ein Label und eine TextBox hinzugefügt. Das Panel-Steuerelement wird mit einem dreidimensionalen Rahmen angezeigt, um die Position des Panel-Steuerelements relativ zur Position anderer Objekte im Formular abzuheben. Für dieses Beispiel ist es erforderlich, dass die hier definierte Methode aus einem vorhandenen Formular heraus aufgerufen wird und dass dem Quellcode des Formulars der System.Drawing-Namespace hinzugefügt wurde.
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
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.Panel
Abgeleitete Klassen
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0