DataGridViewComboBoxCell.Items Propriété

Définition

Obtient les objets qui représentent la sélection affichée dans la liste déroulante.Gets the objects that represent the selection displayed in the drop-down list.

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; }
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection
Public Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection

Valeur de propriété

Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de DataGridViewComboBoxColumn.Items la propriété, qui est semblable à cette propriété.The following code example demonstrates the use of the DataGridViewComboBoxColumn.Items property, which is similar to this property. Cet exemple fait partie d’un exemple plus complet disponible dans DataGridViewComboBoxColumn la rubrique vue d’ensemble de la classe.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

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.This property enables you to obtain a reference to the list of items that are currently stored in the DataGridViewComboBoxCell. Avec cette référence, vous pouvez ajouter des éléments, supprimer des éléments et obtenir le nombre d’éléments dans la collection.With this reference, you can add items, remove items, and obtain a count of the items in the collection. Pour plus d’informations sur les tâches qui peuvent être effectuées avec Items la collection, DataGridViewComboBoxCell.ObjectCollectionconsultez.For more information on the tasks that can be performed with the Items collection, see DataGridViewComboBoxCell.ObjectCollection.

Si des chaînes sont ajoutées Itemsà, ValueMember alors DisplayMember et n’ont pas besoin d’être définies parce que chaque chaîne ajoutée sera utilisée pour la valeur et l’affichage.If strings are added to Items, then ValueMember and DisplayMember do not need to be set because each string added will be used for both value and display.

Notes

DataGridViewComboBoxCellne prend pas en charge l’utilisation de plusieurs éléments avec des valeurs d’affichage identiques.DataGridViewComboBoxCell does not support the use of multiple items with identical display values.

Si la DataSource propriété est définie, la Items propriété ne peut pas être utilisée.If the DataSource property is set, then the Items property cannot be used.

La valeur mise en forme de la cellule doit toujours être l’une des valeurs Items de la collection, sinon une erreur se produit et la valeur de la cellule est restaurée sur le premier élément de la collection.The formatted value of the cell must always be one of the values in the Items collection or an error will occur and the cell value will revert to the first item in the collection. Vous pouvez personnaliser ce comportement en gérant les DataGridView.DataError événements DataGridView.CellFormatting et.You can customize this behavior by handling the DataGridView.DataError and DataGridView.CellFormatting events.

La définition de cette propriété sur une valeur autre que la valeur de la Items propriété de la colonne parente force la ligne à devenir non partagée, en allouant de la mémoire supplémentaire.Setting this property to a value other than the value of the parent column's Items property will force the row to become unshared, allocating extra memory. Pour plus d’informations sur le partage de lignes, consultez meilleures pratiques pour la mise à l’échelle du contrôle DataGridView Windows Forms.For more information about row sharing, see Best Practices for Scaling the Windows Forms DataGridView Control.

S’applique à

Voir aussi