DockStyle-Enumeration

Gibt die Position und Methode zum Andocken eines Steuerelements an.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Enumeration DockStyle
'Usage
Dim instance As DockStyle

public enum DockStyle

public enum class DockStyle

public enum DockStyle

public enum DockStyle

Member

	Membername	Beschreibung
	Bottom	Der untere Rand des Steuerelements wird am unteren Rand des Containersteuerelements angedockt.
	Fill	Alle Ränder des Steuerelements werden an die Ränder des Containersteuerelements angedockt und die Größe entsprechend angepasst.
	Left	Der linke Rand des Steuerelements wird am linken Rand des Containersteuerelements angedockt.
	None	Das Steuerelement wird nicht angedockt.
	Right	Der rechte Rand des Steuerelements wird am rechten Rand des Containersteuerelements angedockt.
	Top	Der obere Rand des Steuerelements wird am oberen Rand des Containersteuerelements angedockt.

Hinweise

Wenn ein Steuerelement am Rand seines Containers angedockt ist, wird es bei jeder Änderung der Containergröße wieder bündig an diesem Rand ausgerichtet. Wenn an einem Rand mehrere Steuerelemente angedockt sind, werden diese Steuerelemente entsprechend ihrer z-Reihenfolge nebeneinander angezeigt, wobei Folgendes gilt: je höher ein Steuerelement in der z-Reihenfolge ist, desto weiter entfernt vom Containerrand ist es positioniert.

Wenn Left, Right, Top oder Bottom ausgewählt ist, werden der angegebene Rand und der gegenüberliegende Rand des Steuerelements an die Größen angepasst, die die entsprechenden Ränder des Containersteuerelements haben. Wenn Fill ausgewählt ist, werden alle vier Ränder des Steuerelements so angepasst, dass sie mit den Rändern des Containersteuerelements übereinstimmen.

Beispiel

Im folgenden Beispiel wird ein GroupBox erstellt, und einige seiner allgemeinen Eigenschaften werden festgelegt. Im Beispiel wird ein TextBox erstellt und sein Location innerhalb des Gruppenfelds festgelegt. Anschließend wird die Text-Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld oben am Formular angedockt. Abschließend wird das Gruppenfeld durch Festlegen der Enabled-Eigenschaft auf false deaktiviert, wodurch alle im Gruppenfeld enthaltenen Steuerelemente deaktiviert werden.

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
    // Create a GroupBox and add a TextBox to it.
    GroupBox groupBox1 = new GroupBox();
    TextBox textBox1 = new TextBox();
    textBox1.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

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

Siehe auch

Referenz

System.Windows.Forms-Namespace
Control.Dock-Eigenschaft