Control.Dock Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ab oder legt fest, welche Steuerelementrahmen an das übergeordnete Steuerelement angedockt werden und bestimmt, wie die Größe eines Steuerelements mit seinem ü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, setPublic Overridable Property Dock As DockStyleEigenschaftswert
Einer der DockStyle Werte. Der Standardwert lautet None.
Ausnahmen
Der zugewiesene Wert ist keiner der DockStyle Werte.
Beispiele
Im folgenden Codebeispiel werden einige GroupBox der allgemeinen Eigenschaften erstellt und festgelegt. Im Beispiel wird ein TextBox Steuerelement erstellt und im Gruppenfeld festgelegt Location . Als Nächstes wird die Text Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld am oberen Rand des Formulars angedockt. Schließlich wird das Gruppenfeld durch Festlegen der Enabled Eigenschaft auf falsedeaktiviert, 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. Beispielsweise bewirkt die Einstellung DockDockStyle.Left , dass sich das Steuerelement an den linken Rändern des übergeordneten Steuerelements ausrichten und die Größe des übergeordneten Steuerelements ändern kann, wenn die Größe des übergeordneten Steuerelements geändert wird. Steuerelemente sind in ihrer Z-Reihenfolge verankert, was die visuelle Schichtung von Steuerelementen auf einem Formular entlang der Z-Achse (Tiefe) des Formulars ist.
Ein Steuerelement kann an einen Rand seines übergeordneten Containers angedockt oder an alle Kanten angedockt werden und den übergeordneten Container ausfüllen.
Das Festlegen der Margin Eigenschaft für ein angedocktes Steuerelement hat keine Auswirkung auf den Abstand des Steuerelements von den Rändern des Containers.
Hinweis
Die Eigenschaften Anchor und Dock schließen sich gegenseitig aus. Es kann nur jeweils 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 Basisklasse Dock , um die Basisimplementierung zu erweitern. Andernfalls müssen Sie alle Implementierungen bereitstellen. Sie müssen nicht sowohl die Eigenschaften als auch die getset Methoden der Dock Eigenschaft außer Kraft setzen. Sie können bei Bedarf nur eine außer Kraft setzen.
