DataGridViewComboBoxColumn.Items Propriedade

Definição

Obtém a coleção de objetos usada como seleção nas caixas de combo.

public:
 property System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ Items { System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ get(); };
public System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection Items { get; }
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection
Public ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection

Valor de Propriedade

Um DataGridViewComboBoxCell.ObjectCollection que representa as escolhas nas caixas de combo.

Exceções

O valor da CellTemplate propriedade é null.

Exemplos

O exemplo de código seguinte demonstra como usar a DataGridViewComboBoxColumn para ajudar na introdução de dados na TitleOfCourtesy coluna. A Items propriedade é usada para preencher a lista suspensa de caixas combo com uma seleção de títulos. Este exemplo faz parte de um exemplo mais amplo disponível no DataGridViewComboBoxColumn tópico de visão geral da aula.

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

Observações

Esta propriedade devolve o valor da Items propriedade devolvida DataGridViewComboBoxCell pela CellTemplate propriedade.

As Items propriedades ou DataSource são usadas para preencher as seleções das caixas de combo.

Se as cadeias forem adicionadas a Items, então as ValueMember propriedades e DisplayMember não precisam de ser definidas porque cada cadeia adicionada será usada tanto para valor como para exibição.

Note

DataGridViewComboBoxColumn não suporta o uso de múltiplos itens com valores de exibição idênticos.

Se a DataSource propriedade estiver definida, então Items não pode ser usada.

Aplica-se a

Ver também