DataGridViewComboBoxCell.Items Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém os objetos que representam a seleção exibida na lista suspensa.

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

DataGridViewComboBoxCell.ObjectCollection

Um DataGridViewComboBoxCell.ObjectCollection que contém a seleção.

Atributos: BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra o uso da DataGridViewComboBoxColumn.Items propriedade , que é semelhante a essa propriedade. 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 permite que você obtenha uma referência à lista de itens armazenados no momento no DataGridViewComboBoxCell. Com essa referência, você pode adicionar itens, remover itens e obter uma contagem dos itens na coleção. Para obter mais informações sobre as tarefas que podem ser executadas com a Items coleção, consulte DataGridViewComboBoxCell.ObjectCollection.

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

Observação

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

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

O valor formatado da célula sempre deve ser um dos valores na Items coleção ou ocorrerá um erro e o valor da célula reverter ao primeiro item da coleção. Você pode personalizar esse comportamento manipulando os DataGridView.DataError eventos e DataGridView.CellFormatting .

Definir essa propriedade como um valor diferente do valor da propriedade da Items coluna pai forçará a linha a se tornar não compartilhada, alocando memória extra. Para obter mais informações sobre compartilhamento de linha, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

Aplica-se a

Compartilhar via