Compartilhar via


TableLayoutPanel.ColumnStyles Propriedade

Definição

Obtém uma coleção de estilos de coluna para o TableLayoutPanel.

public:
 property System::Windows::Forms::TableLayoutColumnStyleCollection ^ ColumnStyles { System::Windows::Forms::TableLayoutColumnStyleCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.TableLayoutColumnStyleCollection ColumnStyles { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ColumnStyles : System.Windows.Forms.TableLayoutColumnStyleCollection
Public ReadOnly Property ColumnStyles As TableLayoutColumnStyleCollection

Valor da propriedade

TableLayoutColumnStyleCollection

Um TableLayoutColumnStyleCollection que contém um ColumnStyle para cada coluna no controle TableLayoutPanel.

Atributos

Exemplos

O exemplo de código a seguir define as ColumnStyle propriedades de cada coluna quando um Button é clicado.

private void toggleColumnStylesBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    TableLayoutColumnStyleCollection styles = 
        this.TableLayoutPanel1.ColumnStyles;

    foreach( ColumnStyle style in styles )
    {
        if( style.SizeType == SizeType.Absolute )
        {
            style.SizeType = SizeType.AutoSize;
        }
        else if( style.SizeType == SizeType.AutoSize )
        {
            style.SizeType = SizeType.Percent;

            // Set the column width to be a percentage
            // of the TableLayoutPanel control's width.
            style.Width = 33;
        }
        else
        {
            // Set the column width to 50 pixels.
            style.SizeType = SizeType.Absolute;
            style.Width = 50;
        }
    }
}
Private Sub toggleColumnStylesBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles toggleColumnStylesBtn.Click

    Dim styles As TableLayoutColumnStyleCollection = _
    Me.TableLayoutPanel1.ColumnStyles

    For Each style As ColumnStyle In styles

        If style.SizeType = SizeType.Absolute Then

            style.SizeType = SizeType.AutoSize

        ElseIf style.SizeType = SizeType.AutoSize Then

            style.SizeType = SizeType.Percent

            ' Set the column width to be a percentage
            ' of the TableLayoutPanel control's width.
            style.Width = 33

        Else

            ' Set the column width to 50 pixels.
            style.SizeType = SizeType.Absolute
            style.Width = 50

        End If

    Next

End Sub

Comentários

Use a ColumnStyles propriedade para acessar as propriedades de estilo de colunas específicas. Você pode usar membros da ColumnStyle classe para definir as características de colunas individuais na tabela.

Quando o TableLayoutPanel controle organiza suas colunas, ele atribui prioridades a cada ColumnStyle uma na seguinte ordem:

  1. As colunas com ColumnStyle conjunto definido Absolute são consideradas primeiro e suas larguras fixas são alocadas.

  2. Colunas com ColumnStyle conjunto a AutoSize ser dimensionado para seu conteúdo.

  3. O espaço restante é dividido entre colunas com ColumnStyle definido como Percent.

Aplica-se a

Confira também