TableLayoutPanel.ColumnStyles Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TableLayoutPanel.cs

Obtient une collection de styles de colonnes pour le 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

Valeur de propriété

TableLayoutColumnStyleCollection

Contenant TableLayoutColumnStyleCollection une ColumnStyle colonne pour chaque colonne du TableLayoutPanel contrôle.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant définit les ColumnStyle propriétés de chaque colonne lorsqu’un Button clic est fait.

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

Remarques

Utilisez la ColumnStyles propriété pour accéder aux propriétés de style de colonnes spécifiques. Vous pouvez utiliser des membres de la ColumnStyle classe pour définir les caractéristiques des colonnes individuelles dans la table.

Lorsque le TableLayoutPanel contrôle organise ses colonnes, il affecte des priorités à chacun ColumnStyle dans l’ordre suivant :

1. Les colonnes dont ColumnStyleAbsolute la valeur est définie sont considérées en premier et leurs largeurs fixes sont allouées.

2. Les colonnes dont ColumnStyle l’ensemble AutoSize est défini sont dimensionnées sur leur contenu.

3. L’espace restant est divisé entre les colonnes avec ColumnStyle la valeur définie sur Percent.

Voir aussi

• ColumnStyle
• RowStyles
• AutoSize Behavior in the TableLayoutPanel Control