TableLayoutPanel.GrowStyle プロパティとは何？わかりやすく解説 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);
    }
}