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

プロパティ値

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

例外

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

次のコード例の値の設定、GrowStyleプロパティに応じて、選択したRadioButtonします。The following code example sets the value of the GrowStyle property depending on the selected RadioButton. 実行時に、ユーザーがボタンがクリックすると、テスト GrowStyleButtonコントロールに追加されます、TableLayoutPanelコントロール。At run time, when the user clicks on the button labeled Test GrowStyle, a Button control is added to the TableLayoutPanel control. 場合、TableLayoutPanelコントロールが完全に、行または列を追加することで展開してまたはの値に応じて、例外が発生GrowStyleします。If 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制御、および値GrowStyleFixedSizeArgumentExceptionがスローされます。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.

適用対象

こちらもご覧ください