DataGridViewComboBoxCell.Items Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera obiekty reprezentujące zaznaczenie wyświetlane na liście rozwijanej.

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

Wartość właściwości

DataGridViewComboBoxCell.ObjectCollection

Element DataGridViewComboBoxCell.ObjectCollection zawierający zaznaczenie.

Atrybuty
BrowsableAttribute

Przykłady

Poniższy przykład kodu przedstawia użycie DataGridViewComboBoxColumn.Items właściwości podobnej do tej właściwości. Ten przykład jest częścią większego przykładu dostępnego DataGridViewComboBoxColumn w temacie przeglądu klasy.

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

Uwagi

Ta właściwość umożliwia uzyskanie odwołania do listy elementów, które są obecnie przechowywane w elemencie DataGridViewComboBoxCell. Dzięki temu odwołaniu można dodawać elementy, usuwać elementy i uzyskiwać liczbę elementów w kolekcji. Aby uzyskać więcej informacji na temat zadań, które można wykonać za Items pomocą kolekcji, zobacz DataGridViewComboBoxCell.ObjectCollection.

Jeśli ciągi są dodawane do Itemselementu , i DisplayMemberValueMember nie trzeba ich ustawiać, ponieważ każdy dodany ciąg będzie używany zarówno dla wartości, jak i wyświetlania.

Uwaga

DataGridViewComboBoxCell nie obsługuje użycia wielu elementów z identycznymi wartościami wyświetlania.

Jeśli właściwość jest ustawiona DataSource , Items nie można użyć właściwości .

Sformatowana wartość komórki musi zawsze być jedną z wartości w Items kolekcji lub wystąpi błąd, a wartość komórki zostanie przywrócona do pierwszego elementu w kolekcji. To zachowanie można dostosować, obsługując DataGridView.DataError zdarzenia i DataGridView.CellFormatting .

Ustawienie tej właściwości na wartość inną niż wartość właściwości kolumny Items nadrzędnej spowoduje wymuszenie udostępnienia wiersza, alokowanie dodatkowej pamięci. Aby uzyskać więcej informacji na temat udostępniania wierszy, zobacz Najlepsze rozwiązania dotyczące skalowania kontrolki Windows Forms DataGridView.

Dotyczy

Zobacz też