Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

TableLayoutPanelGrowStyle Enum

Definition

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public enum class TableLayoutPanelGrowStyle
public enum TableLayoutPanelGrowStyle
type TableLayoutPanelGrowStyle = 
Public Enum TableLayoutPanelGrowStyle
Inheritance
TableLayoutPanelGrowStyle

Fields

Name Value Description
FixedSize 0

The TableLayoutPanel does not allow additional rows or columns after it is full.
AddRows 1

The TableLayoutPanel gains additional rows after it is full.
AddColumns 2

The TableLayoutPanel gains additional columns after it is full.

Examples

The following example shows how to use TableLayoutPanelGrowStyle to set the TableLayoutPanel.GrowStyle property. This 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);
 }
}

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

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.

Applies to

See also

Feedback

Was this page helpful?