TableLayoutPanel.RowStyles Property
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.
Gets a collection of row styles for the TableLayoutPanel.
public:
property System::Windows::Forms::TableLayoutRowStyleCollection ^ RowStyles { System::Windows::Forms::TableLayoutRowStyleCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.TableLayoutRowStyleCollection RowStyles { get; }
[<System.ComponentModel.Browsable(false)>]
member this.RowStyles : System.Windows.Forms.TableLayoutRowStyleCollection
Public ReadOnly Property RowStyles As TableLayoutRowStyleCollection
Property Value
A TableLayoutRowStyleCollection containing a RowStyle for each row in the TableLayoutPanel control.
- Attributes
Examples
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;
}
}
}
Private Sub toggleRowStylesBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles toggleRowStylesBtn.Click
Dim styles As TableLayoutRowStyleCollection = _
Me.TableLayoutPanel1.RowStyles
For Each style As RowStyle In styles
If style.SizeType = SizeType.Absolute Then
style.SizeType = SizeType.AutoSize
ElseIf style.SizeType = SizeType.AutoSize Then
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
End If
Next
End Sub
Remarks
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:
Rows with RowStyle set to Absolute are considered first, and their fixed heights are allocated.
Rows with RowStyle set to AutoSize are sized to their contents.
Remaining space is divided among rows with RowStyle set to Percent.