DataGridView.AutoResizeRows Méthode

Définition

Ajuste la hauteur de tout ou partie des lignes pour s'adapter à leur contenu.

Surcharges

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajuste la hauteur des lignes à l'aide de la valeur du mode de dimensionnement spécifiée.

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

Ajuste la hauteur des lignes spécifiées à l'aide du mode de dimensionnement spécifié, en calculant éventuellement les hauteurs dans l'attente que les largeurs de lignes soient ajustées par la suite.

AutoResizeRows()

Ajuste la hauteur de toutes les lignes pour s'adapter au contenu de toutes leurs cellules, y compris les cellules d'en-tête.

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

Ajuste la hauteur de toutes les lignes à l'aide du mode de dimensionnement spécifié, en calculant éventuellement les hauteurs dans l'attente que les largeurs de colonne soient ajustées par la suite.

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajuste la hauteur des lignes à l'aide de la valeur du mode de dimensionnement spécifiée.

public:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);
public void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit
Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)

Paramètres

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

Une des valeurs de l'objet DataGridViewAutoSizeRowsMode.

Exceptions

autoSizeRowsMode a la valeur AllHeaders ou DisplayedHeaders, et RowHeadersVisible a la valeur false.

autoSizeRowsMode n’est pas une valeur de DataGridViewAutoSizeRowsMode valide.

autoSizeRowsMode a pour valeur None.

Exemples

L’exemple de code suivant montre comment redimensionner toutes les lignes en fonction du contenu de cellule non-en-tête. Cet exemple de code fait partie d’un exemple plus large fourni dans How to: Programally Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Remarques

Cette méthode est utile si vous souhaitez contrôler le moment où les lignes sont redimensionnées. Les hauteurs de ligne ne sont ajustées qu’une seule fois par appel de méthode ; si le contenu des lignes change ultérieurement, les lignes ne s’ajustent pas automatiquement. Pour redimensionner une ligne spécifique, utilisez la AutoResizeRow méthode . Pour redimensionner un sous-ensemble de lignes, utilisez la AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) surcharge. Pour définir le redimensionnement automatique des lignes chaque fois que leur contenu change, utilisez la AutoSizeRowsMode propriété .

Pour que le contenu de cellule soit encapsulé sur plusieurs lignes lorsqu’une ligne est redimensionnée, le style de cellule en vigueur pour la cellule doit avoir la WrapMode valeur de Truepropriété .

Cette surcharge vous permet de spécifier un mode de dimensionnement qui calcule les nouvelles hauteurs en fonction des valeurs d’un ensemble limité de cellules, telles que celles des lignes affichées uniquement. Cela améliore les performances lorsque le contrôle contient un grand nombre de lignes.

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

Ajuste la hauteur des lignes spécifiées à l'aide du mode de dimensionnement spécifié, en calculant éventuellement les hauteurs dans l'attente que les largeurs de lignes soient ajustées par la suite.

protected:
 void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRows (int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Paramètres

rowIndexStart
Int32

Index de la première ligne à redimensionner.

rowsCount
Int32

Nombre de lignes à redimensionner.

autoSizeRowMode
DataGridViewAutoSizeRowMode

Une des valeurs de l'objet DataGridViewAutoSizeRowMode.

fixedWidth
Boolean

true pour calculer les nouvelles hauteurs en fonction des largeurs de colonne actuelles ; false pour calculer les hauteurs dans l'attente que les largeurs de colonne soient également ajustées.

Exceptions

autoSizeRowsMode a la valeur AllHeaders ou DisplayedHeaders, et RowHeadersVisible a la valeur false.

autoSizeRowsMode n’est pas une valeur de DataGridViewAutoSizeRowsMode valide.

autoSizeRowsMode a pour valeur None.

rowIndexStart est inférieur à 0.

- ou -

rowsCount est inférieur à 0.

Remarques

Cette méthode est utile si vous souhaitez contrôler le moment où les lignes se redimensionnent, mais que vous souhaitez redimensionner uniquement un sous-ensemble spécifique de lignes, par exemple celles qui se trouvent dans une plage d’enregistrements liés qui ont été mis à jour. Les hauteurs de ligne pour les lignes spécifiées ne sont ajustées qu’une seule fois par appel de méthode ; si le contenu des lignes change ultérieurement, les lignes ne s’ajustent pas automatiquement. Pour redimensionner une ligne spécifique, utilisez la AutoResizeRow méthode . Pour redimensionner toutes les lignes, utilisez une surcharge différente de la AutoResizeRows méthode . Pour définir le redimensionnement automatique des lignes chaque fois que leur contenu change, utilisez la AutoSizeRowsMode propriété .

Pour que le contenu de cellule soit encapsulé sur plusieurs lignes lorsqu’une ligne est redimensionnée, le style de cellule en vigueur pour la cellule doit avoir la WrapMode valeur de Truepropriété .

Cette surcharge vous permet de spécifier un mode de dimensionnement qui calcule les nouvelles hauteurs en fonction des valeurs d’un ensemble limité de cellules, telles que celles des lignes affichées uniquement. Cela améliore les performances lorsque le contrôle contient un grand nombre de lignes.

Cette surcharge est protégée et est conçue pour vous permettre d’obtenir des ratios hauteur/largeur de cellule idéaux dans une classe dérivée DataGridView . Si le fixedWidth paramètre est false, les hauteurs de ligne sont calculées avec l’attente que vous appelez la AutoResizeColumn méthode ou AutoResizeColumns suivant.

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à

AutoResizeRows()

Ajuste la hauteur de toutes les lignes pour s'adapter au contenu de toutes leurs cellules, y compris les cellules d'en-tête.

public:
 void AutoResizeRows();
public void AutoResizeRows ();
member this.AutoResizeRows : unit -> unit
Public Sub AutoResizeRows ()

Exemples

L’exemple de code suivant montre comment redimensionner toutes les lignes en fonction du contenu de cellule non-en-tête. Cet exemple de code fait partie d’un exemple plus large fourni dans How to: Programally Resize Cells to Fit Content in the Windows Forms DataGridView Control.

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Remarques

Cette méthode est utile si vous souhaitez contrôler le moment où les lignes sont redimensionnées. Les hauteurs de ligne ne sont ajustées qu’une seule fois par appel de méthode ; si le contenu des lignes change ultérieurement, les lignes ne s’ajustent pas automatiquement. Pour redimensionner une ligne spécifique, utilisez la AutoResizeRow méthode . Pour redimensionner un sous-ensemble de lignes, utilisez la AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) surcharge. Pour définir le redimensionnement automatique des lignes chaque fois que leur contenu change, utilisez la AutoSizeRowsMode propriété .

Pour que le contenu de cellule soit encapsulé sur plusieurs lignes lorsqu’une ligne est redimensionnée, le style de cellule en vigueur pour la cellule doit avoir la WrapMode valeur de Truepropriété .

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

Ajuste la hauteur de toutes les lignes à l'aide du mode de dimensionnement spécifié, en calculant éventuellement les hauteurs dans l'attente que les largeurs de colonne soient ajustées par la suite.

protected:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
protected void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit
Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)

Paramètres

autoSizeRowsMode
DataGridViewAutoSizeRowsMode

Une des valeurs de l'objet DataGridViewAutoSizeRowsMode.

fixedWidth
Boolean

true pour calculer les nouvelles hauteurs en fonction des largeurs de colonne actuelles ; false pour calculer les hauteurs dans l'attente que les largeurs de colonne soient également ajustées.

Exceptions

autoSizeRowsMode a la valeur AllHeaders ou DisplayedHeaders, et RowHeadersVisible a la valeur false.

autoSizeRowsMode n’est pas une valeur de DataGridViewAutoSizeRowsMode valide.

autoSizeRowsMode a pour valeur None.

Remarques

Cette méthode est utile si vous souhaitez contrôler le moment où les lignes sont redimensionnées. Les hauteurs de ligne ne sont ajustées qu’une seule fois par appel de méthode ; si le contenu des lignes change ultérieurement, les lignes ne s’ajustent pas automatiquement. Pour redimensionner une ligne spécifique, utilisez la AutoResizeRow méthode . Pour redimensionner un sous-ensemble de lignes, utilisez la AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) surcharge. Pour définir le redimensionnement automatique des lignes chaque fois que leur contenu change, utilisez la AutoSizeRowsMode propriété .

Pour que le contenu de cellule soit encapsulé sur plusieurs lignes lorsqu’une ligne est redimensionnée, le style de cellule en vigueur pour la cellule doit avoir la WrapMode valeur de Truepropriété .

Cette surcharge vous permet de spécifier un mode de dimensionnement qui calcule les nouvelles hauteurs en fonction des valeurs d’un ensemble limité de cellules, telles que celles des lignes affichées uniquement. Cela améliore les performances lorsque le contrôle contient un grand nombre de lignes.

Cette surcharge est protégée et est conçue pour vous permettre d’obtenir des ratios hauteur/largeur de cellule idéaux dans une classe dérivée DataGridView . Si le fixedWidth paramètre est false, les hauteurs de ligne sont calculées avec l’attente que vous appelez la AutoResizeColumn méthode ou AutoResizeColumns suivant.

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à