DataGridViewComboBoxCell.Items DataGridViewComboBoxCell.Items DataGridViewComboBoxCell.Items DataGridViewComboBoxCell.Items Property

Definición

Obtiene los objetos que representan la selección mostrados en la lista desplegable.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

Valor de propiedad

Ejemplos

En el ejemplo de código siguiente se muestra el DataGridViewComboBoxColumn.Items uso de la propiedad, que es similar a esta propiedad.The following code example demonstrates the use of the DataGridViewComboBoxColumn.Items property, which is similar to this property. Este ejemplo forma parte de un ejemplo más grande disponible en DataGridViewComboBoxColumn el tema de información general de la clase.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

Comentarios

Esta propiedad permite obtener una referencia a la lista de elementos que están almacenados actualmente en DataGridViewComboBoxCell.This property enables you to obtain a reference to the list of items that are currently stored in the DataGridViewComboBoxCell. Con esta referencia, puede agregar elementos, quitar elementos y obtener un recuento de los elementos de la colección.With this reference, you can add items, remove items, and obtain a count of the items in the collection. Para obtener más información sobre las tareas que se pueden realizar con Items la colección, DataGridViewComboBoxCell.ObjectCollectionvea.For more information on the tasks that can be performed with the Items collection, see DataGridViewComboBoxCell.ObjectCollection.

Si las cadenas se agregan Itemsa ValueMember , DisplayMember y no tienen que establecerse porque cada cadena agregada se utilizará para el valor y para la presentación.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.

Nota

DataGridViewComboBoxCellno admite el uso de varios elementos con valores de presentación idénticos.DataGridViewComboBoxCell does not support the use of multiple items with identical display values.

Si se DataSource establece la propiedad, no se Items puede utilizar la propiedad.If the DataSource property is set, then the Items property cannot be used.

El valor con formato de la celda siempre debe ser uno de los valores de Items la colección o se producirá un error y el valor de la celda volverá al primer elemento de la colección.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. Puede personalizar este comportamiento mediante el control de DataGridView.DataError los DataGridView.CellFormatting eventos y.You can customize this behavior by handling the DataGridView.DataError and DataGridView.CellFormatting events.

Si se establece esta propiedad en un valor distinto del valor de la Items propiedad de la columna primaria, se forzará a que la fila deje de estar compartida y se asignará memoria adicional.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. Para obtener más información sobre el uso compartido de filas, vea prácticas recomendadas para escalar el control DataGridView Windows Forms.For more information about row sharing, see Best Practices for Scaling the Windows Forms DataGridView Control.

Se aplica a

Consulte también: