(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Control.Dock-Eigenschaft

Ruft einen Wert ab oder legt einen Wert fest, der angibt an welchen Seiten das Control am übergeordneten Container angedockt seion soll. Damit wird bestimmt, wie sich die Größe des Steuerelements ändert, wenn sich die Größe des Containers ändert.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual DockStyle Dock { get; set; }

Eigenschaftswert

Typ: System.Windows.Forms.DockStyle
Einer der DockStyle-Werte. Der Standardwert ist None.

AusnahmeBedingung
InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der DockStyle-Werte.

Definieren Sie mit der Dock-Eigenschaft, wie die Größe eines Steuerelements automatisch geändert wird, sobald die Größe seines übergeordneten Steuerelements geändert wird. Das Festlegen von Dock auf DockStyle.Left bewirkt z. B., dass das Steuerelement sich selbst am linken Rand seines übergeordneten Steuerelements ausrichtet und seine Größe ändert, sobald die Größe des übergeordneten Steuerelements geändert wird. Steuerelemente werden in ihrer Z-Reihenfolge angedockt, die die visuelle Überlagerung der Steuerelemente auf einem Formular entlang der Z-Achse (Tiefe) des Formulars darstellt.

Ein Steuerelement kann an einen Rand des übergeordneten Containers oder an alle Ränder angedockt werden und den übergeordneten Container ausfüllen.

Das Festlegen der Margin-Eigenschaft für ein angedocktes Steuerelement wirkt sich nicht auf den Abstand des Steuerelements von den Rändern des Containers aus.

HinweisHinweis

Die Anchor-Eigenschaft und die Dock-Eigenschaft schließen einander gegenseitig aus. Zum gleichen Zeitpunkt kann jeweils nur eine festgelegt werden, und die letzte Gruppe hat Vorrang.

Hinweise zur Vererbung

Verwenden Sie beim Überschreiben der Dock-Eigenschaft in einer abgeleiteten Klasse die Dock-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl die get-Methode als auch die set-Methode der Dock-Eigenschaft überschreiben. Sie können ggf. auch nur eine Methode überschreiben.

Im folgenden Codebeispiel wird eine GroupBox erstellt, und einige ihrer 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 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);
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft