DockStyle Enumeração

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Especifica a posição e a forma como um comando está acoplado.

public enum class DockStyle
public enum DockStyle
type DockStyle = 
Public Enum DockStyle
Herança
Object
ValueType
Enum
DockStyle

Campos

Name Valor Description
None 0

O comando não está acoplado.
Top 1

A borda superior do comando está acoplada ao topo do seu controlo de contenção.
Bottom 2

A borda inferior do comando está acoplada à base do seu comando de contenção.
Left 3

A borda esquerda do comando está acoplada à borda esquerda do seu controlo de contenção.
Right 4

A borda direita do comando está acoplada à borda direita do seu controlo de contenção.
Fill 5

Todas as arestas do controlo estão acopladas a todas as arestas do seu controlo contendo e têm o tamanho adequado.

Exemplos

O exemplo seguinte cria um GroupBox e define algumas das suas propriedades comuns. O exemplo cria um TextBox e define o seu Location dentro da caixa do grupo. De seguida, define a Text propriedade da caixa de grupo e encaixa a caixa de grupo no topo do formulário. Por fim, desativa a caixa de grupo ao definir a Enabled propriedade para false, o que faz com que todos os controlos contidos na caixa de grupo fiquem desativados.

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

Observações

Quando um controlo está acoplado a uma borda do seu contentor, ele está sempre posicionado encostado a essa borda quando o contentor é redimensionado. Se mais do que um comando estiver acoplado a uma aresta, os controlos aparecem lado a lado de acordo com a sua ordem z; os controlos mais altos na ordem z estão posicionados mais afastados da borda do contentor.

Se for selecionado Esquerda, Direita, Cima ou Baixo, as arestas especificadas e opostas do controlo são redimensionadas para o tamanho das arestas correspondentes do controlo que o contém. Se for selecionado Preenchimento, todos os quatro lados do controlo são redimensionados para corresponder às arestas do controlo que o contém.

Aplica-se a

Ver também