DockStyle Enumeração

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Especifica a posição e a maneira como um controle está encaixado.

public enum class DockStyle

public enum DockStyle

type DockStyle = 

Public Enum DockStyle

Herança

Object

ValueType

Enum

DockStyle

Campos

Bottom	2	A borda inferior do controle está encaixada na parte inferior do controle recipiente.
Fill	5	Todas as bordas do controle estão encaixadas em todas as bordas do controle recipiente e dimensionadas adequadamente.
Left	3	A borda esquerda do controle está encaixada na borda esquerda do controle recipiente.
None	0	O controle não está encaixado.
Right	4	A borda direita do controle está encaixada na borda direita do controle recipiente.
Top	1	A borda superior do controle está encaixada na parte superior do controle recipiente.

Exemplos

O exemplo a seguir cria e GroupBox define algumas de suas propriedades comuns. O exemplo cria um TextBox e define seu Location dentro da caixa de grupo. Em seguida, ele define a Text propriedade da caixa de grupo e encaixa a caixa de grupo na parte superior do formulário. Por fim, ele desabilita a caixa de grupo definindo a propriedade comofalse, o Enabled que faz com que todos os controles contidos na caixa de grupo sejam desabilitados.

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

Comentários

Quando um controle é encaixado em uma borda de seu contêiner, ele sempre é posicionado contra essa borda quando o contêiner é redimensionado. Se mais de um controle estiver encaixado em uma borda, os controles aparecerão lado a lado de acordo com sua ordem z; os controles mais altos na ordem z são posicionados mais longe da borda do contêiner.

Se as bordas esquerda, direita, superior ou inferior estiverem selecionadas, as bordas especificadas e opostas do controle serão redimensionadas para o tamanho das bordas correspondentes do controle. Se Fill estiver selecionado, todos os quatro lados do controle serão redimensionados para corresponder às bordas do controle independente.

Confira também

• Dock