TableLayoutPanel.GrowStyle Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si le contrôle TableLayoutPanel doit se développer pour accepter de nouvelles cellules lorsque toutes les cellules existantes sont occupées.

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

Valeur de propriété

TableLayoutPanelGrowStyle

TableLayoutPanelGrowStyle indiquant le schéma de croissance. La valeur par défaut est AddRows.

Exceptions

ArgumentException

La valeur de propriété n'est pas valide pour l'énumération TableLayoutPanelGrowStyle.

Exemples

L’exemple de code suivant définit la valeur de la GrowStyle propriété en fonction du sélectionné RadioButton. Au moment de l’exécution, quand l’utilisateur clique sur le bouton intitulé Test GrowStyle, un Button contrôle est ajouté au TableLayoutPanel contrôle. Si le TableLayoutPanel contrôle est complet, il se développe en ajoutant une ligne ou une colonne, ou il lève une exception, en fonction de la valeur de 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

Remarques

Par défaut, le contrôle TableLayoutPanel s'étend vers le bas en ajoutant des lignes.

Notes

Si une tentative d’ajout d’un contrôle à un contrôle complet TableLayoutPanel est effectuée et que la valeur de GrowStyle est FixedSize, une ArgumentException est levée.

Voir aussi

• ColumnCount
• RowCount