DataGridViewComboBoxCell.Items Propiedad

Definición

Obtiene los objetos que representan la selección mostrados en la lista desplegable.

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

Valor de propiedad

Una colección DataGridViewComboBoxCell.ObjectCollection que contiene la selección.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la DataGridViewComboBoxColumn.Items propiedad , que es similar a esta propiedad. Este ejemplo forma parte de un ejemplo más grande disponible en el tema de información general de la DataGridViewComboBoxColumn clase.

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

Comentarios

Esta propiedad permite obtener una referencia a la lista de elementos almacenados actualmente en .DataGridViewComboBoxCell Con esta referencia, puede agregar elementos, quitar elementos y obtener un recuento de los elementos de la colección. Para obtener más información sobre las tareas que se pueden realizar con la Items colección, vea DataGridViewComboBoxCell.ObjectCollection.

Si las cadenas se agregan a Items, ValueMember no es necesario establecer y DisplayMember , ya que cada cadena agregada se usará para el valor y la presentación.

Nota

DataGridViewComboBoxCell no admite el uso de varios elementos con valores de visualización idénticos.

Si se establece la DataSource propiedad , no se puede usar la Items propiedad .

El valor con formato de la celda siempre debe ser uno de los valores de la Items colección o se producirá un error y el valor de celda volverá al primer elemento de la colección. Puede personalizar este comportamiento controlando los DataGridView.DataError eventos y DataGridView.CellFormatting .

Si se establece esta propiedad en un valor distinto del valor de la propiedad de Items la columna primaria, se forzará a que la fila deje de compartirse, asignando memoria adicional. Para obtener más información sobre cómo compartir filas, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.

Se aplica a

Consulte también