Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Propriedade Control.Dock

 

Obtém ou define quais bordas do controle são encaixadas no controle pai e determina como um controle é redimensionado com seu pai.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public virtual DockStyle Dock { get; set; }

Valor da Propriedade

Type: System.Windows.Forms.DockStyle

Um dos valores de DockStyle. O padrão é None.

Exception Condition
InvalidEnumArgumentException

O valor atribuído não é um dos valores DockStyle.

Use the P:System.Windows.Forms.Control.Dock property to define how a control is automatically resized as its parent control is resized. For example, setting P:System.Windows.Forms.Control.Dock to F:System.Windows.Forms.DockStyle.Left causes the control to align itself with the left edges of its parent control and to resize as the parent control is resized. Controls are docked in their Z-order, which is the visual layering of controls on a form along the form's Z-axis (depth).

A control can be docked to one edge of its parent container or can be docked to all edges and fill the parent container.

Setting the P:System.Windows.Forms.Control.Margin property on a docked control has no effect on the distance of the control from the the edges of its container.

System_CAPS_noteObservação

The P:System.Windows.Forms.Control.Anchor and P:System.Windows.Forms.Control.Dock properties are mutually exclusive. Only one can be set at a time, and the last one set takes precedence.

Observações para os Herdeiros:

When overriding the P:System.Windows.Forms.Control.Dock property in a derived class, use the base class's P:System.Windows.Forms.Control.Dock property to extend the base implementation. Otherwise, you must provide all the implementation. You are not required to override both the get and set methods of the P:System.Windows.Forms.Control.Dock property; you can override only one if needed.

The following code example creates a T:System.Windows.Forms.GroupBox and sets some of its common properties. The example creates a T:System.Windows.Forms.TextBox and sets its P:System.Windows.Forms.Control.Location within the group box. Next, it sets the P:System.Windows.Forms.Control.Text property of the group box, and docks the group box to the top of the form. Lastly, it disables the group box by setting the P:System.Windows.Forms.Control.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 = 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);
}

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: