TableLayoutPanel.ColumnStyles Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

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: BrowsableAttribute

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:

As colunas com ColumnStyle conjunto definido Absolute são consideradas primeiro e suas larguras fixas são alocadas.
Colunas com ColumnStyle conjunto a AutoSize ser dimensionado para seu conteúdo.
O espaço restante é dividido entre colunas com ColumnStyle definido como Percent.

Aplica-se a