TableLayoutPanel.GrowStyle Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob das TableLayoutPanel-Steuerelement um neue Zellen erweitert werden soll, wenn alle vorhandenen Zellen belegt sind, oder legt diesen Wert fest.

public:
 property System::Windows::Forms::TableLayoutPanelGrowStyle GrowStyle { System::Windows::Forms::TableLayoutPanelGrowStyle get(); void set(System::Windows::Forms::TableLayoutPanelGrowStyle value); };
public System.Windows.Forms.TableLayoutPanelGrowStyle GrowStyle { get; set; }
member this.GrowStyle : System.Windows.Forms.TableLayoutPanelGrowStyle with get, set
Public Property GrowStyle As TableLayoutPanelGrowStyle

Eigenschaftswert

TableLayoutPanelGrowStyle

Ein TableLayoutPanelGrowStyle, der das Zunahmeschema angibt. Der Standardwert ist AddRows.

Ausnahmen

ArgumentException

Der Eigenschaftswert ist für die TableLayoutPanelGrowStyle-Enumeration ungültig.

Beispiele

Im folgenden Codebeispiel wird der Wert der GrowStyle Eigenschaft je nach ausgewählter RadioButtonEigenschaft festgelegt. Wenn der Benutzer zur Laufzeit auf die Schaltfläche " Test GrowStyle" klickt, wird dem Steuerelement ein Button Steuerelement hinzugefügt TableLayoutPanel . Wenn das TableLayoutPanel Steuerelement voll ist, wird es durch Hinzufügen einer Zeile oder Spalte erweitert, oder es löst eine Ausnahme aus, abhängig vom Wert von 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);
    }
}

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

Hinweise

Standardmäßig wird das TableLayoutPanel-Steuerelement nach unten erweitert, indem Zeilen hinzufügt werden.

Hinweis

Wenn ein Versuch vorgenommen wird, ein Steuerelement zu einem vollständigen TableLayoutPanel Steuerelement hinzuzufügen, und der Wert GrowStyle FixedSizedes Werts ist, wird ein ArgumentException Ausgelöst.

Gilt für

Siehe auch