Control.Dock Proprietà

Definizione

Ottiene o imposta i bordi di controllo ancorati al relativo controllo padre e determina la modalità con cui un controllo viene ridimensionato con il proprio 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à

Uno dei valori di DockStyle. Il valore predefinito è None.

Eccezioni

Il valore assegnato non è uno dei valori di DockStyle.

Esempio

L'esempio di codice seguente crea un oggetto GroupBox e imposta alcune delle relative proprietà comuni. Nell'esempio viene creato un oggetto TextBox e viene impostato Location all'interno della casella di gruppo. Imposta quindi la Text proprietà della casella di gruppo e ancora la casella di gruppo viene ancorata alla parte superiore del modulo. Infine, disabilita la casella di gruppo impostando la Enabled proprietà su false, che causa 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 Dock proprietà per definire la modalità di ridimensionamento automatico di un controllo quando viene ridimensionato il controllo padre. Ad esempio, l'impostazione Dock per DockStyle.Left causare l'allineamento del controllo a se stesso con i bordi sinistro del controllo padre e il ridimensionamento quando il controllo padre viene ridimensionato. I controlli vengono ancorati nell'ordine Z, ovvero il livello visivo dei controlli su una maschera lungo l'asse Z del modulo (profondità).

Un controllo può essere ancorato a un bordo del contenitore padre o 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 contenitore.

Nota

Le Anchor proprietà e si escludono Dock a vicenda. Solo uno può essere impostato alla volta e l'ultimo set ha la precedenza.

Note per gli eredi

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

Si applica a

Vedi anche