DockStyle Enumerazione

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DockStyle.cs

Specifica la posizione e il modo in cui un controllo è ancorato.

public enum class DockStyle

public enum DockStyle

type DockStyle = 

Public Enum DockStyle

Ereditarietà

Object

ValueType

Enum

DockStyle

Campi

Nome	Valore	Descrizione
None	0	Il controllo non è ancorato.
Top	1	Il bordo superiore del controllo è ancorato alla parte superiore del controllo contenitore.
Bottom	2	Il bordo inferiore del controllo è ancorato alla parte inferiore del controllo contenitore.
Left	3	Il bordo sinistro del controllo è ancorato al bordo sinistro del controllo contenitore.
Right	4	Il bordo destro del controllo è ancorato al bordo destro del controllo contenitore.
Fill	5	Tutti i bordi del controllo vengono ancorati a tutti i bordi del controllo contenitore e ridimensionati in modo appropriato.

Esempio

Nell'esempio 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

Quando un controllo viene ancorato a un bordo del contenitore, viene sempre posizionato sullo scaricamento rispetto a tale bordo quando il contenitore viene ridimensionato. Se più controlli sono ancorati a un bordo, i controlli vengono visualizzati affiancati in base all'ordine z; i controlli più alti nell'ordine z sono posizionati più lontano dal bordo del contenitore.

Se è selezionata l'opzione Left, Right, Top o Bottom, i bordi specificati e opposti del controllo vengono ridimensionati in base alle dimensioni dei bordi corrispondenti del controllo contenitore. Se l'opzione Riempimento è selezionata, tutti e quattro i lati del controllo vengono ridimensionati in modo che corrispondano ai bordi del controllo contenitore.

Vedi anche

• Dock