TableLayoutPanel.ColumnStyles Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine Auflistung der Spaltenformate für das TableLayoutPanel ab.

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

Eigenschaftswert

TableLayoutColumnStyleCollection

Eine TableLayoutColumnStyleCollection, die im ColumnStyle-Steuerelement einen TableLayoutPanel für jede Spalte enthält.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel werden die ColumnStyle Eigenschaften jeder Spalte festgelegt, wenn auf eine Button geklickt wird.

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

Hinweise

Verwenden Sie die ColumnStyles -Eigenschaft, um auf die Formateigenschaften bestimmter Spalten zuzugreifen. Sie können Member der ColumnStyle -Klasse verwenden, um die Merkmale einzelner Spalten in der Tabelle festzulegen.

Wenn das TableLayoutPanel Steuerelement seine Spalten anordnet, weist es diesen ColumnStyle Prioritäten in der folgenden Reihenfolge zu:

Spalten mit ColumnStyle festgelegt auf Absolute werden zuerst betrachtet, und ihre festen Breiten werden zugeordnet.
Spalten mit ColumnStyle festgelegt auf AutoSize werden entsprechend ihrem Inhalt dimensioniert.
Der verbleibende Speicherplatz wird in Spalten unterteilt, die ColumnStyle auf Percentfestgelegt sind.

Gilt für:

Freigeben über