DataGridView.AutoSizeRowsMode Propriété
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.
Obtient ou définit une valeur indiquant la façon dont 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, setPublic Property AutoSizeRowsMode As DataGridViewAutoSizeRowsModeValeur de propriété
Valeur DataGridViewAutoSizeRowsMode indiquant le mode de dimensionnement. La valeur par défaut est None.
Exceptions
Valeur spécifiée lors de la définition de cette propriété n’est pas une valeur valide DataGridViewAutoSizeRowsMode .
Valeur spécifiée lors de la définition de cette propriété AllHeaders ou DisplayedHeaders et des en-têtes de ligne sont masqués.
Exemples
L’exemple de code suivant montre comment définir la ligne à redimensionner automatiquement 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 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 ligne soient automatiquement ajustées pour s’adapter à leur contenu chaque fois que le contenu change. Si WrapMode elle est activée, les hauteurs de ligne sont également ajustées chaque fois que les largeurs de colonne changent. 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 dont Visible la valeur de true propriété est redimensionnée sont redimensionnées automatiquement et la modification de la visibilité d’une ligne ne provoque pas le redimensionnement. En outre, lorsque les lignes sont définies pour redimensionner automatiquement, l’utilisateur ne peut pas ajuster les hauteurs de ligne avec la souris.
La Height valeur d’une ligne de taille automatique est recalculée pendant la disposition pour tenir compte de la taille de la police utilisée. Pour obtenir la valeur correcte Height, vous devez récupérer la valeur dans l’événement du Layout formulaire au lieu du constructeur du formulaire.
Pour ajuster les hauteurs de ligne par programmation, utilisez le ou AutoResizeRows les AutoResizeRow méthodes, ou définissez la propriété de ligneHeight.
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 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.
