DockStyle DockStyle DockStyle DockStyle Enum

Definição

Especifica a posição e a maneira como um controle está encaixado.Specifies the position and manner in which a control is docked.

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

Campos

Bottom Bottom Bottom Bottom 2

A borda inferior do controle está encaixada na parte inferior do controle recipiente.The control's bottom edge is docked to the bottom of its containing control.

Fill Fill Fill Fill 5

Todas as bordas do controle estão encaixadas em todas as bordas do controle recipiente e dimensionadas adequadamente.All the control's edges are docked to the all edges of its containing control and sized appropriately.

Left Left Left Left 3

A borda esquerda do controle está encaixada na borda esquerda do controle recipiente.The control's left edge is docked to the left edge of its containing control.

None None None None 0

O controle não está encaixado.The control is not docked.

Right Right Right Right 4

A borda direita do controle está encaixada na borda direita do controle recipiente.The control's right edge is docked to the right edge of its containing control.

Top Top Top Top 1

A borda superior do controle está encaixada na parte superior do controle recipiente.The control's top edge is docked to the top of its containing control.

Exemplos

O exemplo a seguir cria GroupBox um e define algumas de suas propriedades comuns.The following example creates a GroupBox and sets some of its common properties. O exemplo cria um TextBox e define seu Location na caixa de grupo.The example creates a TextBox and sets its Location within the group box. Em seguida, ele define Text a propriedade da caixa de grupo e encaixa a caixa de grupo na parte superior do formulário.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Por fim, ele desabilita a caixa de grupo definindo a Enabled Propriedade como false, o que faz com que todos os controles contidos na caixa de grupo sejam desabilitados.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // 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 com base nessa borda quando o contêiner é redimensionado.When a control is docked to an edge of its container, it is always positioned flush against that edge when the container is resized. Se mais de um controle for 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 distantes da borda do contêiner.If more than one control is docked to an edge, the controls appear side by side according to their z-order; controls higher in the z-order are positioned farther from the container's edge.

Se esquerda, direita, superior ou inferior estiver selecionada, as bordas especificadas e opostas do controle serão redimensionadas para o tamanho das bordas correspondentes do controle recipiente.If Left, Right, Top, or Bottom is selected, the specified and opposite edges of the control are resized to the size of the containing control's corresponding edges. Se Fill for selecionado, todos os quatro lados do controle serão redimensionados para corresponder às bordas do controle recipiente.If Fill is selected, all four sides of the control are resized to match the containing control's edges.

Aplica-se a

Veja também