Control.Dock Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

Control.cs

Ottiene o imposta i bordi di controllo ancorati al controllo padre e determina il modo in cui un controllo viene ridimensionato con il relativo elemento padre.

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

Valore della proprietà

DockStyle

Uno dei DockStyle valori. Il valore predefinito è None.

Eccezioni

InvalidEnumArgumentException

Il valore assegnato non è uno dei DockStyle valori.

Esempio

Nell'esempio di codice seguente viene creato un GroupBox oggetto e vengono impostate alcune delle relative proprietà comuni. Nell'esempio viene creato un TextBox oggetto e viene Location impostato all'interno della casella di gruppo. Imposta quindi la Text proprietà della casella di gruppo e ancora la casella di gruppo nella parte superiore del modulo. Infine, disabilita la casella di gruppo impostando la Enabled proprietà su false, che determina la disabilitazione di tutti i controlli contenuti nella casella di gruppo.

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

Commenti

Utilizzare la proprietà per definire il Dock modo in cui un controllo viene ridimensionato automaticamente man mano che viene ridimensionato il controllo padre. Ad esempio, impostando Dock su DockStyle.Left , il controllo viene allineato con i bordi sinistro del relativo controllo padre e ridimensionarlo man mano che il controllo padre viene ridimensionato. I controlli sono ancorati nell'ordine Z, ovvero il livello visivo dei controlli in una maschera lungo l'asse Z (profondità).

Un controllo può essere ancorato a un bordo del contenitore padre oppure può essere ancorato a tutti i bordi e riempire il contenitore padre.

L'impostazione della Margin proprietà su un controllo ancorato non ha alcun effetto sulla distanza del controllo dai bordi del relativo contenitore.

Annotazioni

Le Anchor proprietà e Dock si escludono a vicenda. È possibile impostare un solo set alla volta e l'ultimo set ha la precedenza.

Note per gli eredi

Quando si esegue l'override della Dock proprietà in una classe derivata, utilizzare la proprietà della classe di base per estendere l'implementazione di Dock base. In caso contrario, è necessario fornire tutte le implementazioni. Non è necessario eseguire l'override get dei metodi e set della Dock proprietà. Se necessario, è possibile eseguire l'override di uno solo.

Vedi anche

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout