DataGridView.AutoSizeRowsMode Propriété

Définition

Obtient ou définit une valeur indiquant comment les hauteurs de ligne sont déterminées.

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. La valeur par défaut est None.

Exceptions

La valeur spécifiée au moment de la définition de cette propriété n’est pas une valeur DataGridViewAutoSizeRowsMode valide.

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.

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 ligne et de toutes les colonnes. Cet exemple de code fait partie d’un exemple plus large fourni dans How to: Automatically Resize Cells When Content Changes in the Windows Forms Contrôle DataGridView.

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 des lignes soient automatiquement ajustées pour s’adapter à leur contenu chaque fois que le contenu change. Si WrapMode est activé, les hauteurs de ligne sont également ajustées chaque fois que la largeur des colonnes change. Certains modes de dimensionnement vous permettent de limiter l’ajustement de taille aux lignes actuellement affichées afin d’augmenter les performances.

Seules les lignes ayant une Visible valeur de true propriété sont redimensionnées automatiquement, et la modification de la visibilité d’une ligne n’entraîne pas de redimensionnement. En outre, lorsque les lignes sont définies pour un redimensionnement automatique, l’utilisateur ne peut pas ajuster les hauteurs de ligne avec la souris.

La Height valeur d’une ligne dimensionnée automatiquement est recalculée pendant la disposition pour tenir compte de la taille de la police utilisée. Pour obtenir le bon Height, vous devez récupérer la valeur dans l’événement du Layout formulaire au lieu de dans le constructeur du formulaire.

Pour ajuster les hauteurs de ligne par programmation, utilisez les AutoResizeRow méthodes ou AutoResizeRows ou définissez la propriété de ligne Height .

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 la WrapMode valeur de Truepropriété .

Pour plus d’informations sur le dimensionnement automatique basé sur le contenu, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

S’applique à

Voir aussi