Export (0) Print
Expand All

TableLayoutPanel.RowStyles Property

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

Gets a collection of row styles for the TableLayoutPanel.

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

public TableLayoutRowStyleCollection RowStyles { get; }
/** @property */
public TableLayoutRowStyleCollection get_RowStyles ()

public function get RowStyles () : TableLayoutRowStyleCollection

Property Value

A TableLayoutRowStyleCollection containing a RowStyle for each row in the TableLayoutPanel control.

Use the RowStyles property to access the style properties of specific rows. You can use members of the RowStyle class to set the characteristics of individual rows in the table.

When the TableLayoutPanel control arranges its rows, it assigns priorities to each RowStyle in the following order:

  1. Rows with RowStyle set to Absolute are considered first, and their fixed heights are allocated.

  2. Rows with RowStyle set to AutoSize are sized to their contents.

  3. Remaining space is divided among rows with RowStyle set to Percent.

The following code example sets the RowStyle properties of each row when a Button is clicked.

private void toggleRowStylesBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    TableLayoutRowStyleCollection styles = 
        this.TableLayoutPanel1.RowStyles;

    foreach( RowStyle style in styles )
    {
        if (style.SizeType==SizeType.Absolute)
        {
            style.SizeType = SizeType.AutoSize;
        }
        else if(style.SizeType==SizeType.AutoSize)
        {
            style.SizeType = SizeType.Percent;

            // Set the row height to be a percentage
            // of the TableLayoutPanel control's height.
            style.Height = 33;
        }
        else
        {

            // Set the row height to 50 pixels.
            style.SizeType = SizeType.Absolute;
            style.Height = 50;
        }
    }
}

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.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft