DataGridViewComboBoxCell.Items Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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.ObjectCollection
Public Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection

Valeur de propriété

DataGridViewComboBoxCell.ObjectCollection

DataGridViewComboBoxCell.ObjectCollection contenant la sélection.

Attributs
BrowsableAttribute

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 .DataGridViewComboBoxCell Avec cette référence, vous pouvez ajouter des éléments, supprimer des éléments et obtenir un nombre d’éléments dans 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éfinis, car chaque chaîne ajoutée sera utilisée à la fois pour la valeur et l’affichage.

Notes

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, sinon 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 DataGridView.DataError événements et DataGridView.CellFormatting .

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 à ne pas être partagée, ce qui alloue de la mémoire supplémentaire. Pour plus d’informations sur le partage de lignes, consultez Meilleures pratiques pour la mise à l’échelle du contrôle DataGridView Windows Forms.

S’applique à

Voir aussi