TableLayoutPanel.GrowStyle TableLayoutPanel.GrowStyle TableLayoutPanel.GrowStyle TableLayoutPanel.GrowStyle Property

定義

既存のセルがすべて占有されている場合に、新しいセルを追加できるように TableLayoutPanel コントロールを拡張するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the TableLayoutPanel control should expand to accommodate new cells when all existing cells are occupied.

public:
 property System::Windows::Forms::TableLayoutPanelGrowStyle GrowStyle { System::Windows::Forms::TableLayoutPanelGrowStyle get(); void set(System::Windows::Forms::TableLayoutPanelGrowStyle value); };
public System.Windows.Forms.TableLayoutPanelGrowStyle GrowStyle { get; set; }
member this.GrowStyle : System.Windows.Forms.TableLayoutPanelGrowStyle with get, set
Public Property GrowStyle As TableLayoutPanelGrowStyle

プロパティ値

拡張スキームを示す TableLayoutPanelGrowStyleA TableLayoutPanelGrowStyle indicating the growth scheme. 既定値は、AddRows です。The default is AddRows.

例外

TableLayoutPanelGrowStyle 列挙体のプロパティ値が無効です。The property value is invalid for the TableLayoutPanelGrowStyle enumeration.

次のコード例では、選択しGrowStyleRadioButtonに応じて、プロパティの値を設定します。The following code example sets the value of the GrowStyle property depending on the selected RadioButton. 実行時に、テスト growstyle Buttonというラベルが付いたボタンをユーザーがクリックすると、コントロールTableLayoutPanelがコントロールに追加されます。At run time, when the user clicks on the button labeled Test GrowStyle, a Button control is added to the TableLayoutPanel control. コントロールがいっぱいの場合は、行または列を追加することによって展開されるか、のGrowStyle値に応じて例外が発生します。 TableLayoutPanelIf the TableLayoutPanel control is full, it expands by adding a row or column, or it raises an exception, depending on the value of GrowStyle.

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

注釈

既定では、TableLayoutPanel コントロールは行を追加することで下方向に拡張します。By default, the TableLayoutPanel control expands downward by adding rows.

注意

コントロールをフルTableLayoutPanelコントロールに追加しようとしたときに、の値FixedSizeArgumentExceptionGrowStyle場合は、がスローされます。If an attempt is made to add a control to a full TableLayoutPanel control, and the value of GrowStyle is FixedSize, then an ArgumentException is thrown.

適用対象

こちらもご覧ください