TableLayoutPanel.ColumnStyles プロパティ

.NET Framework クラス ライブラリ リファレンス

TableLayoutPanel.ColumnStyles プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

TableLayoutPanel の列スタイルのコレクションを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 ColumnStyles As TableLayoutColumnStyleCollection

Visual Basic (使用法)

Dim instance As TableLayoutPanel
Dim value As TableLayoutColumnStyleCollection

value = instance.ColumnStyles

C#

public TableLayoutColumnStyleCollection ColumnStyles { get;
 }

C++

public:
property TableLayoutColumnStyleCollection^ ColumnStyles {
    TableLayoutColumnStyleCollection^ get ();
}

J#

/** @property */
public TableLayoutColumnStyleCollection get_ColumnStyles ()

JScript

public function get ColumnStyles
 () : TableLayoutColumnStyleCollection

プロパティ値
TableLayoutPanel コントロール内の各列の ColumnStyle を格納している TableLayoutColumnStyleCollection。

解説

ColumnStyles プロパティを使用すると、特定の列のスタイル プロパティにアクセスできます。ColumnStyle クラスのメンバを使用すると、テーブル内の個別の列の特性を設定できます。

TableLayoutPanel コントロールが列を配置する場合、各 ColumnStyle に次の順序で優先順位を割り当てます。

1. ColumnStyle が Absolute に設定されている列が最初に考慮され、固定幅が割り当てられます。

2. ColumnStyle が AutoSize に設定されている列のサイズは、内容に合わせて変更されます。

3. 残りの領域は、ColumnStyle が Percent に設定されている列の間で分割されます。

使用例

Button がクリックされたときに各列の ColumnStyle プロパティを設定するコード例を次に示します。

Visual Basic

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

C#

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;
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TableLayoutPanel クラス
TableLayoutPanel メンバ
System.Windows.Forms 名前空間
ColumnStyle クラス
RowStyles
その他の技術情報
TableLayoutPanel コントロールにおける AutoSize 動作