DataGridView.AutoSizeRowsMode Propriété

Définition

Obtient ou définit une valeur indiquant comment les hauteurs de ligne sont déterminées.Gets or sets a value indicating how row heights are determined.

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

Valeur de propriété

Valeur DataGridViewAutoSizeRowsMode indiquant le mode de dimensionnement.A DataGridViewAutoSizeRowsMode value indicating the sizing mode. La valeur par défaut est None,The default is None.

Exceptions

La valeur spécifiée lors de la définition de cette propriété n’est pas une valeur DataGridViewAutoSizeRowsMode valide.The specified value when setting this property is not a valid DataGridViewAutoSizeRowsMode value.

La valeur spécifiée lors de la définition de cette propriété est AllHeaders ou DisplayedHeaders, et les en-têtes de ligne sont masqués.The specified value when setting this property is AllHeaders or DisplayedHeaders and row headers are hidden.

Exemples

L’exemple de code suivant montre comment définir le redimensionnement automatique de la ligne en fonction du contenu des en-têtes de lignes et de toutes les colonnes.The following code example demonstrates how to set the row to automatically resize based on the contents of the row headers and all of the columns. Cet exemple de code fait partie d’un exemple plus complet fourni dans Comment : redimensionner automatiquement des cellules lorsque le contenu est modifié dans le contrôle DataGridView Windows Forms.This code example is part of a larger example provided in How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}
private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}
Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Remarques

Cette propriété vous permet de configurer le contrôle afin que les hauteurs de lignes soient ajustées automatiquement en fonction de leur contenu chaque fois que le contenu change.This property lets you configure the control so that row heights are automatically adjusted to fit their contents whenever the contents change. Si WrapMode est activé, les hauteurs de lignes sont également ajustées à chaque modification des largeurs de colonne.If WrapMode is enabled, row heights are also adjusted whenever column widths change. Certains modes de dimensionnement vous permettent de limiter le réglage de taille aux lignes actuellement affichées afin d’améliorer les performances.Some sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Seules les lignes avec une valeur de propriété Visible de true sont redimensionnées automatiquement, et la modification de la visibilité d’une ligne ne provoque pas de redimensionnement.Only rows with a Visible property value of true are resized automatically, and changing the visibility of a row does not cause resizing to occur. En outre, lorsque les lignes sont configurées pour un redimensionnement automatique, l’utilisateur ne peut pas ajuster les hauteurs de lignes à l’aide de la souris.Additionally, when rows are set to automatically resize, the user cannot adjust the row heights with the mouse.

La valeur Height d’une ligne dimensionnée automatiquement est recalculée au cours de la disposition pour tenir compte de la taille de la police utilisée.The Height value of an automatically sized row is recalculated during layout to account for the size of the font that is used. Pour obtenir la Heightcorrecte, vous devez récupérer la valeur dans l’événement de Layout du formulaire plutôt que dans le constructeur du formulaire.To get the correct Height, you should retrieve the value in the form's Layout event instead of in the form's constructor.

Pour ajuster les hauteurs de lignes par programmation, utilisez les méthodes AutoResizeRow ou AutoResizeRows, ou définissez la propriété Row Height.To adjust row heights programmatically, use the AutoResizeRow or AutoResizeRows methods, or set the row Height property.

Pour que le contenu de la cellule soit encapsulé sur plusieurs lignes lorsqu’une ligne est redimensionnée, le style de cellule en vigueur pour la cellule doit avoir une valeur de propriété WrapMode de True.For cell contents to wrap onto multiple lines when a row is resized, the cell style in effect for the cell must have a WrapMode property value of True.

Pour plus d’informations sur le dimensionnement automatique basé sur le contenu, consultez options de dimensionnement dans le contrôle DataGridView Windows Forms.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

S’applique à

Voir aussi