DataGridView.MultiSelect, propriété
Assembly : System.Windows.Forms (dans system.windows.forms.dll)
/** @property */ public boolean get_MultiSelect () /** @property */ public void set_MultiSelect (boolean value)
public function get MultiSelect () : boolean public function set MultiSelect (value : boolean)
Non applicable.
Valeur de la propriété
true si l'utilisateur peut sélectionner plusieurs cellules, lignes ou colonnes à la fois ; sinon, false. La valeur par défaut est true.Lorsque la propriété MultiSelect a la valeur true, plusieurs éléments (cellules, lignes ou colonnes) peuvent être sélectionnés dans le contrôle DataGridView. Pour sélectionner plusieurs éléments, l'utilisateur peut maintenir enfoncée la touche CTRL et cliquer sur les éléments à sélectionner. Il est possible de sélectionner des éléments adjacents en cliquant sur le premier élément, puis en cliquant sur le dernier élément tout en maintenant enfoncée la touche MAJ. La portée de sélection est basée sur la propriété SelectionMode. Par exemple, si SelectionMode a la valeur DataGridViewSelectionMode.FullColumnSelect, l'utilisateur peut sélectionner plusieurs colonnes.
Vous pouvez utiliser la propriété MultiSelect pour permettre à un utilisateur de sélectionner plusieurs éléments dans le contrôle DataGridView et d'exécuter une opération sur tous les éléments sélectionnés. Par exemple, l'utilisateur peut sélectionner plusieurs cellules et cliquer avec le bouton droit sur l'une de ces cellules pour afficher un menu contextuel proposant une liste des tâches disponibles pour les cellules sélectionnées.
Pour déterminer les cellules, lignes ou colonnes qui sont sélectionnées dans le contrôle DataGridView, vous pouvez accéder à la propriété SelectedCells, SelectedRows ou SelectedColumns. Pour déterminer le nombre des cellules sélectionnées, appelez la méthode GetCellCount avec une valeur d'argument égale à DataGridViewElementStates.Selected. Utilisez la méthode GetRowCount pour récupérer le nombre des lignes sélectionnées et la méthode GetColumnCount pour récupérer le nombre des colonnes. Ces méthodes sont plus efficaces que l'accès direct aux collections lorsque vous utilisez des quantités importantes de données. Pour plus d'informations, consultez Méthodes conseillées pour la mise à l'échelle du contrôle DataGridView Windows Forms.
L'exemple de code suivant montre comment utiliser la propriété MultiSelect. Pour exécuter cet exemple, collez le code dans un formulaire qui contient un DataGridView nommé dataGridView1 et appelez ensuite la méthode SetUpDataGridView à partir du constructeur ou du gestionnaire d'événements Load du formulaire. Vérifiez que tous les événements sont associés à leurs gestionnaires d'événements.
private void SetUpDataGridView() { this.Controls.Add(dataGridView1); dataGridView1.ColumnCount = 5; DataGridViewCellStyle style = dataGridView1.ColumnHeadersDefaultCellStyle; style.BackColor = Color.Navy; style.ForeColor = Color.White; style.Font = new Font(dataGridView1.Font, FontStyle.Bold); dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter; dataGridView1.Name = "dataGridView1"; dataGridView1.Location = new Point(8, 8); dataGridView1.Size = new Size(500, 300); dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders; dataGridView1.ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Raised; dataGridView1.CellBorderStyle = DataGridViewCellBorderStyle.Single; dataGridView1.GridColor = SystemColors.ActiveBorder; dataGridView1.RowHeadersVisible = false; dataGridView1.Columns[0].Name = "Release Date"; dataGridView1.Columns[1].Name = "Track"; dataGridView1.Columns[1].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter; dataGridView1.Columns[2].Name = "Title"; dataGridView1.Columns[3].Name = "Artist"; dataGridView1.Columns[4].Name = "Album"; // Make the font italic for row four. dataGridView1.Columns[4].DefaultCellStyle.Font = new Font(DataGridView.DefaultFont, FontStyle.Italic); dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect; dataGridView1.MultiSelect = false; dataGridView1.BackgroundColor = Color.Honeydew; dataGridView1.Dock = DockStyle.Fill; dataGridView1.CellFormatting += new DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting); dataGridView1.CellParsing += new DataGridViewCellParsingEventHandler(dataGridView1_CellParsing); addNewRowButton.Click += new EventHandler(addNewRowButton_Click); deleteRowButton.Click += new EventHandler(deleteRowButton_Click); ledgerStyleButton.Click += new EventHandler(ledgerStyleButton_Click); dataGridView1.CellValidating += new DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating); }
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.