DataGridViewComboBoxCell.Items 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 les objets qui représentent la sélection affichée dans la liste déroulante.
public:
virtual property System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ Items { System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public virtual System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection Items { get; }[<System.ComponentModel.Browsable(false)>]
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollectionPublic Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollectionValeur de propriété
Contenant DataGridViewComboBoxCell.ObjectCollection la sélection.
- Attributs
Exemples
L’exemple de code suivant illustre l’utilisation de la DataGridViewComboBoxColumn.Items propriété, qui est similaire à cette propriété. Cet exemple fait partie d’un exemple plus large disponible dans la rubrique vue d’ensemble de la DataGridViewComboBoxColumn classe.
private:
void SetAlternateChoicesUsingItems(
DataGridViewComboBoxColumn^ comboboxColumn)
{
comboboxColumn->Items->AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
}
private:
DataGridViewComboBoxColumn^ CreateComboBoxColumn()
{
DataGridViewComboBoxColumn^ column =
gcnew DataGridViewComboBoxColumn();
{
column->DataPropertyName = ColumnName::TitleOfCourtesy.ToString();
column->HeaderText = ColumnName::TitleOfCourtesy.ToString();
column->DropDownWidth = 160;
column->Width = 90;
column->MaxDropDownItems = 3;
column->FlatStyle = FlatStyle::Flat;
}
return column;
}
private static void SetAlternateChoicesUsingItems(
DataGridViewComboBoxColumn comboboxColumn)
{
comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
}
private DataGridViewComboBoxColumn CreateComboBoxColumn()
{
DataGridViewComboBoxColumn column =
new DataGridViewComboBoxColumn();
{
column.DataPropertyName = ColumnName.TitleOfCourtesy.ToString();
column.HeaderText = ColumnName.TitleOfCourtesy.ToString();
column.DropDownWidth = 160;
column.Width = 90;
column.MaxDropDownItems = 3;
column.FlatStyle = FlatStyle.Flat;
}
return column;
}
Private Shared Sub SetAlternateChoicesUsingItems( _
ByVal comboboxColumn As DataGridViewComboBoxColumn)
comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.")
End Sub
Private Function CreateComboBoxColumn() _
As DataGridViewComboBoxColumn
Dim column As New DataGridViewComboBoxColumn()
With column
.DataPropertyName = ColumnName.TitleOfCourtesy.ToString()
.HeaderText = ColumnName.TitleOfCourtesy.ToString()
.DropDownWidth = 160
.Width = 90
.MaxDropDownItems = 3
.FlatStyle = FlatStyle.Flat
End With
Return column
End Function
Remarques
Cette propriété vous permet d’obtenir une référence à la liste des éléments actuellement stockés dans le DataGridViewComboBoxCell. Avec cette référence, vous pouvez ajouter des éléments, supprimer des éléments et obtenir le nombre d’éléments de la collection. Pour plus d’informations sur les tâches qui peuvent être effectuées avec la Items collection, consultez DataGridViewComboBoxCell.ObjectCollection.
Si des chaînes sont ajoutées à Items, et ValueMemberDisplayMember n’ont pas besoin d’être définies, car chaque chaîne ajoutée sera utilisée pour la valeur et l’affichage.
Note
DataGridViewComboBoxCell ne prend pas en charge l’utilisation de plusieurs éléments avec des valeurs d’affichage identiques.
Si la DataSource propriété est définie, la Items propriété ne peut pas être utilisée.
La valeur mise en forme de la cellule doit toujours être l’une des valeurs de la Items collection ou une erreur se produit et la valeur de la cellule revient au premier élément de la collection. Vous pouvez personnaliser ce comportement en gérant les événements et DataGridView.CellFormatting les DataGridView.DataError événements.
La définition de cette propriété sur une valeur autre que la valeur de la propriété de Items la colonne parente force la ligne à devenir non partagé, en allouant de la mémoire supplémentaire. Pour plus d’informations sur le partage de lignes, consultez Les meilleures pratiques pour la mise à l’échelle du contrôle DataGridView Windows Forms.
