Freigeben über


TableLayoutPanel.GrowStyle Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das TableLayoutPanel Steuerelement erweitert werden soll, um neue Zellen aufzunehmen, wenn alle vorhandenen Zellen belegt sind.

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

Ein TableLayoutPanelGrowStyle Hinweis auf das Wachstumsschema. Der Standardwert lautet AddRows.

Ausnahmen

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 mit der Bezeichnung "Test GrowStyle" klickt, wird dem TableLayoutPanel Steuerelement ein Button Steuerelement hinzugefügt. Wenn das TableLayoutPanel Steuerelement voll ist, wird es erweitert, indem eine Zeile oder Spalte hinzugefügt wird, 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 durch Hinzufügen von Zeilen nach unten erweitert.

Hinweis

Wenn versucht wird, einem Vollzugriff TableLayoutPanel ein Steuerelement hinzuzufügen, und der Wert des GrowStyle Werts ist FixedSize, wird ein ArgumentException Fehler ausgelöst.

Gilt für:

Weitere Informationen