Control.Dock-Eigenschaft

Artikel
08/20/2007

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.

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

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overridable Property Dock As DockStyle
'Usage
Dim instance As Control
Dim value As DockStyle

value = instance.Dock

instance.Dock = value

[LocalizableAttribute(true)] 
public virtual DockStyle Dock { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property DockStyle Dock {
    DockStyle get ();
    void set (DockStyle value);
}

/** @property */
public DockStyle get_Dock ()

/** @property */
public void set_Dock (DockStyle value)

public function get Dock () : DockStyle

public function set Dock (value : DockStyle)

Eigenschaftenwert

Einer der DockStyle-Werte. Der Standardwert ist None.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidEnumArgumentException	Der zugewiesene Wert ist keiner der DockStyle-Werte.

Hinweise

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.

Hinweis

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 für Erben 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.

Beispiel

Im folgenden Codebeispiel wird eine GroupBox erstellt, und einige ihrer allgemeinen Eigenschaften werden festgelegt. Im Beispiel wird eine TextBox erstellt. Außerdem wird ihre 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

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
DockStyle
Control.Anchor-Eigenschaft
ScrollableControl.DockPaddingEdges
Layout

Freigeben über