TableLayoutPanelGrowStyleとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

TableLayoutPanel.GrowStyle プロパティ

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

既存のセルがすべて占有されている場合に、新しいセルを追加できるように TableLayoutPanel コントロールを拡張するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property GrowStyle As
 TableLayoutPanelGrowStyle

Visual Basic (使用法)

Dim instance As TableLayoutPanel
Dim value As TableLayoutPanelGrowStyle

value = instance.GrowStyle

instance.GrowStyle = value

public TableLayoutPanelGrowStyle GrowStyle { get;
 set; }

C++

public:
property TableLayoutPanelGrowStyle GrowStyle {
    TableLayoutPanelGrowStyle get ();
    void set (TableLayoutPanelGrowStyle value);
}

/** @property */
public TableLayoutPanelGrowStyle get_GrowStyle ()

/** @property */
public void set_GrowStyle (TableLayoutPanelGrowStyle
 value)

JScript

public function get GrowStyle
 () : TableLayoutPanelGrowStyle

public function set GrowStyle
 (value : TableLayoutPanelGrowStyle)

プロパティ値
拡張スキームを示す TableLayoutPanelGrowStyle。既定値は AddRows です。

例外

例外の種類	条件
ArgumentException	TableLayoutPanelGrowStyle 列挙体のプロパティ値が無効です。

解説

既定では、TableLayoutPanel コントロールは行の追加によって下方向に拡張します。

メモ
いっぱいの TableLayoutPanel コントロールにコントロールを追加しようとしたときに、GrowStyle の値が FixedSize の場合、ArgumentException がスローされます。

使用例

選択した RadioButton に応じて GrowStyle プロパティの値を設定するコードの例を次に示します。実行時にユーザーが [Test GrowStyle] というラベルの付いたボタンをクリックすると、Button コントロールが TableLayoutPanel コントロールに追加されます。TableLayoutPanel コントロールがいっぱいの場合、GrowStyle の値に応じて、行または列の追加によってコントロールが拡張されるか、または例外が発生します。

Visual Basic

Private Sub growStyleNoneBtn_CheckedChanged(
 _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleNoneBtn.CheckedChanged

    Me.tlpGrowStyle = TableLayoutPanelGrowStyle.FixedSize

End Sub

Private Sub growStyleAddRowBtn_CheckedChanged(
 _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleAddRowBtn.CheckedChanged

    Me.tlpGrowStyle = TableLayoutPanelGrowStyle.AddRows

End Sub

Private Sub growStyleAddColumnBtn_CheckedChanged(
 _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleAddColumnBtn.CheckedChanged

    Me.tlpGrowStyle = TableLayoutPanelGrowStyle.AddColumns

End Sub

Private Sub testGrowStyleBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles testGrowStyleBtn.Click

    Me.TableLayoutPanel1.GrowStyle = Me.tlpGrowStyle

    Try

        Me.TableLayoutPanel1.Controls.Add(New
 Button())

    Catch ex As ArgumentException

        Trace.WriteLine(ex.Message)

    End Try

End Sub

private void growStyleNoneBtn_CheckedChanged(
    System.Object sender, 
    System.EventArgs e)
{
    this.tlpGrowStyle = TableLayoutPanelGrowStyle.FixedSize;
}

private void growStyleAddRowBtn_CheckedChanged(
    System.Object sender, 
    System.EventArgs e)
{
    this.tlpGrowStyle = TableLayoutPanelGrowStyle.AddRows;
}

private void growStyleAddColumnBtn_CheckedChanged(
    System.Object sender, 
    System.EventArgs e)
{
    this.tlpGrowStyle = TableLayoutPanelGrowStyle.AddColumns;
}

private void testGrowStyleBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    this.TableLayoutPanel1.GrowStyle = this.tlpGrowStyle;

    try
    {
        this.TableLayoutPanel1.Controls.Add(new
 Button());
    }
    catch(ArgumentException ex)
    {
        Trace.WriteLine(ex.Message);
    }
}

プラットフォーム

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 名前空間
TableLayoutPanel.ColumnCount プロパティ
RowCount

TableLayoutPanelGrowStyle 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

既存のセルがいっぱいになった後、TableLayoutPanel が追加の行または列を取得する方法を指定します。

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

Visual Basic (宣言)

Public Enumeration TableLayoutPanelGrowStyle

Visual Basic (使用法)

Dim instance As TableLayoutPanelGrowStyle

public enum TableLayoutPanelGrowStyle

C++

public enum class TableLayoutPanelGrowStyle

public enum TableLayoutPanelGrowStyle

JScript

public enum TableLayoutPanelGrowStyle

メンバ

	メンバ名	説明
	AddColumns	TableLayoutPanel は、いっぱいになった後、追加列を取得します。
	AddRows	TableLayoutPanel は、いっぱいになった後、追加行を取得します。
	FixedSize	TableLayoutPanel は、いっぱいになった後、行または列の追加を許可しません。

解説

TableLayoutPanel 内のすべてのセルがいっぱいになったときに、GrowStyle プロパティが FixedSize に設定されている場合、別のコントロールを追加しようとすると、例外がスローされます。

使用例

TableLayoutPanelGrowStyle を使用して、TableLayoutPanel コントロールの GrowStyle プロパティを設定する方法を次の例に示します。このコード例は TableLayoutPanel コントロールのトピックで取り上げているコード例の一部です。

Visual Basic

Private Sub growStyleNoneBtn_CheckedChanged(
 _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleNoneBtn.CheckedChanged

    Me.tlpGrowStyle = TableLayoutPanelGrowStyle.FixedSize

End Sub

Private Sub growStyleAddRowBtn_CheckedChanged(
 _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleAddRowBtn.CheckedChanged

    Me.tlpGrowStyle = TableLayoutPanelGrowStyle.AddRows

End Sub

Private Sub growStyleAddColumnBtn_CheckedChanged(
 _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles growStyleAddColumnBtn.CheckedChanged

    Me.tlpGrowStyle = TableLayoutPanelGrowStyle.AddColumns

End Sub

Private Sub testGrowStyleBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles testGrowStyleBtn.Click

    Me.TableLayoutPanel1.GrowStyle = Me.tlpGrowStyle

    Try

        Me.TableLayoutPanel1.Controls.Add(New
 Button())

    Catch ex As ArgumentException

        Trace.WriteLine(ex.Message)

    End Try

End Sub

private void growStyleNoneBtn_CheckedChanged(
    System.Object sender, 
    System.EventArgs e)
{
    this.tlpGrowStyle = TableLayoutPanelGrowStyle.FixedSize;
}

private void growStyleAddRowBtn_CheckedChanged(
    System.Object sender, 
    System.EventArgs e)
{
    this.tlpGrowStyle = TableLayoutPanelGrowStyle.AddRows;
}

private void growStyleAddColumnBtn_CheckedChanged(
    System.Object sender, 
    System.EventArgs e)
{
    this.tlpGrowStyle = TableLayoutPanelGrowStyle.AddColumns;
}

private void testGrowStyleBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    this.TableLayoutPanel1.GrowStyle = this.tlpGrowStyle;

    try
    {
        this.TableLayoutPanel1.Controls.Add(new
 Button());
    }
    catch(ArgumentException ex)
    {
        Trace.WriteLine(ex.Message);
    }
}