TableLayoutPanel.GrowStyle Свойство

Определение

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

public System.Windows.Forms.TableLayoutPanelGrowStyle GrowStyle { get; set; }

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

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

Исключения

Значение свойства является недопустимым для перечисления 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);
    }
}

Комментарии

По умолчанию элемент управления TableLayoutPanel развертывается вниз путем добавления строк.

Примечание

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

Применяется к

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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