DockStyle Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica a posição e a maneira em que um controle está encaixado.
public enum class DockStylepublic enum DockStyletype DockStyle = Public Enum DockStyle- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| None | 0 | O controle não está encaixado. |
| Top | 1 | A borda superior do controle é encaixada na parte superior do controle que contém. |
| Bottom | 2 | A borda inferior do controle é encaixada na parte inferior do controle que contém. |
| Left | 3 | A borda esquerda do controle é encaixada na borda esquerda do controle que contém. |
| Right | 4 | A borda direita do controle está encaixada na borda direita do controle que contém. |
| Fill | 5 | Todas as bordas do controle são encaixadas em todas as bordas de seu controle independente e dimensionadas adequadamente. |
Exemplos
O exemplo a seguir cria um GroupBox e define algumas de suas propriedades comuns. O exemplo cria um TextBox e define sua 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 como false, 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 a 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 que contém. Se Fill estiver selecionado, todos os quatro lados do controle serão redimensionados para corresponder às bordas do controle que contém.
