This topic has not yet been rated - Rate this topic

TableLayoutPanelGrowStyle Enumeration

.NET Framework 2.0

Other Versions

Note: This enumeration is new in the .NET Framework version 2.0.

Specifies how a TableLayoutPanel will gain additional rows or columns after its existing cells are full.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

C++

public enum TableLayoutPanelGrowStyle

public enum TableLayoutPanelGrowStyle

JScript

public enum TableLayoutPanelGrowStyle

Members

	Member name	Description
	AddColumns	The TableLayoutPanel gains additional columns after it is full.
	AddRows	The TableLayoutPanel gains additional rows after it is full.
	FixedSize	The TableLayoutPanel does not allow additional rows or columns after it is full.

Remarks

If all the cells in the TableLayoutPanel are filled and the GrowStyle property is set to FixedSize, an attempt to add another control will throw an exception.

Example

The following example shows how to use TableLayoutPanelGrowStyle to set the GrowStyle property on a TableLayoutPanel control. This code example is part of a larger example provided for the TableLayoutPanel control.

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

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0

Reference

System.Windows.Forms Namespace
TableLayoutPanel.GrowStyle Property
TableLayoutPanel Class

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD