TableLayoutPanel.GrowStyle Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

TableLayoutPanel.cs

Возвращает или задает значение, указывающее, должен ли TableLayoutPanel элемент управления расширяться для размещения новых ячеек, когда все существующие ячейки заняты.

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

Значение свойства

TableLayoutPanelGrowStyle

Значение TableLayoutPanelGrowStyle , указывающее схему роста. Значение по умолчанию — AddRows.

Исключения

ArgumentException

Значение свойства недопустимо для TableLayoutPanelGrowStyle перечисления.

Примеры

Следующий пример кода задает значение GrowStyle свойства в зависимости от выбранного RadioButton. Во время выполнения, когда пользователь нажимает кнопку Test GrowStyle, элемент Button управления добавляется в TableLayoutPanel элемент управления. TableLayoutPanel Если элемент управления заполнен, он расширяется путем добавления строки или столбца или вызывает исключение в зависимости от значения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 добавляя строки.

Замечание

Если предпринята попытка добавить элемент управления в полный TableLayoutPanel элемент управления, а значение GrowStyle имеет FixedSizeзначение, ArgumentException вызывается.

См. также раздел

• ColumnCount
• RowCount