DataGridViewComboBoxColumn.Items Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém a coleção de objetos usados como seleções nas caixas de combinação.

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 da propriedade

DataGridViewComboBoxCell.ObjectCollection

Um DataGridViewComboBoxCell.ObjectCollection que representa as seleções nas caixas de combinação.

Exceções

InvalidOperationException

O valor da propriedade CellTemplate é null.

Exemplos

O exemplo de código a seguir demonstra como usar um DataGridViewComboBoxColumn para auxiliar na inserção de dados na TitleOfCourtesy coluna. A Items propriedade é usada para preencher a lista suspensa da caixa de combinação com uma seleção de títulos. Este exemplo faz parte de um exemplo maior disponível no tópico de visão geral da 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

Comentários

Essa propriedade retorna o valor da Items propriedade do DataGridViewComboBoxCell retornado pela CellTemplate propriedade.

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

Se as cadeias de caracteres forem adicionadasItems, as propriedades e DisplayMember as ValueMember propriedades não precisarão ser definidas porque cada cadeia de caracteres adicionada será usada para valor e exibição.

Observação

DataGridViewComboBoxColumn não dá suporte ao uso de vários itens com valores de exibição idênticos.

Se a DataSource propriedade estiver definida, não Items poderá ser usada.

Aplica-se a

Confira também