DataGridView.AutoResizeRows Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
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.