Teilen über

Control.Dock Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft ab oder legt fest, welche Steuerelementrahmen am übergeordneten Steuerelement angedockt sind, und bestimmt, wie die Größe eines Steuerelements mit dem übergeordneten Steuerelement geändert wird.

public:
 virtual property System::Windows::Forms::DockStyle Dock { System::Windows::Forms::DockStyle get(); void set(System::Windows::Forms::DockStyle value); };
public virtual System.Windows.Forms.DockStyle Dock { get; set; }
member this.Dock : System.Windows.Forms.DockStyle with get, set
Public Overridable Property Dock As DockStyle

Eigenschaftswert

DockStyle

Einer der DockStyle-Werte. Der Standardwert ist None.

Ausnahmen

InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der DockStyle-Werte.

Beispiele

Im folgenden Codebeispiel wird ein GroupBox erstellt und einige der allgemeinen Eigenschaften festgelegt. Im Beispiel wird ein TextBox erstellt und innerhalb des Gruppenfelds festgelegt Location . Als Nächstes wird die Text -Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld am anfang des Formulars angedockt. Schließlich wird das Gruppenfeld deaktiviert, indem die Enabled -Eigenschaft auf falsefestgelegt wird, wodurch alle im Gruppenfeld enthaltenen Steuerelemente deaktiviert werden.

   // 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.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 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

Hinweise

Verwenden Sie die Dock -Eigenschaft, um zu definieren, wie die Größe eines Steuerelements automatisch geändert wird, wenn die Größe des übergeordneten Steuerelements geändert wird. Wenn Sie beispielsweise auf DockStyle.Left festlegenDock, wird das Steuerelement am linken Rand des übergeordneten Steuerelements ausgerichtet und die Größe des übergeordneten Steuerelements geändert. Steuerelemente werden in ihrer Z-Reihenfolge angedockt. Dies ist die visuelle Überschichtung von Steuerelementen auf einem Formular entlang der Z-Achse (Tiefe).

Ein Steuerelement kann an einen Rand des übergeordneten Containers angedockt oder an allen Kanten angedockt werden und den übergeordneten Container füllen.

Das Festlegen der Margin -Eigenschaft für ein angedocktes Steuerelement hat keine Auswirkungen auf den Abstand des Steuerelements von den Rändern des Containers.

Hinweis

Die Anchor Eigenschaften und Dock schließen sich gegenseitig aus. Es kann jeweils nur ein Satz festgelegt werden, und der letzte Satz hat Vorrang.

Hinweise für Vererber

Verwenden Sie beim Überschreiben der Dock -Eigenschaft in einer abgeleiteten Klasse die -Eigenschaft der Dock Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Es ist nicht erforderlich, sowohl die -Methode als set auch die get -Methode der Dock -Eigenschaft außer Kraft zu setzen. Sie können bei Bedarf nur eine überschreiben.

Gilt für:

Weitere Informationen