DataGridViewComboBoxCell.Items Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает объекты, представляющие элементы, отображаемые в раскрывающемся списке.

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

Значение свойства

DataGridViewComboBoxCell.ObjectCollection

Объект DataGridViewComboBoxCell.ObjectCollection, содержащий выделенный элемент.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода показано использование DataGridViewComboBoxColumn.Items свойства , аналогичного этому свойству. Этот пример является частью более крупного примера, доступного в DataGridViewComboBoxColumn разделе обзора класса.

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

Комментарии

Это свойство позволяет получить ссылку на список элементов, которые в настоящее время хранятся в DataGridViewComboBoxCell. С помощью этой ссылки можно добавлять элементы, удалять их и получать количество элементов в коллекции. Дополнительные сведения о задачах, которые можно выполнять с коллекцией, см. в Items разделе DataGridViewComboBoxCell.ObjectCollection.

Если строки добавляются в Items, то ValueMember и DisplayMember не нужно задавать, так как каждая добавленная строка будет использоваться как для значения, так и для отображения.

Примечание

DataGridViewComboBoxCell не поддерживает использование нескольких элементов с одинаковыми отображаемыми значениями.

DataSource Если свойство задано, то Items свойство нельзя использовать.

Форматируемое значение ячейки всегда должно быть одним из значений в коллекции, Items иначе возникнет ошибка и значение ячейки будет отменить изменения к первому элементу в коллекции. Это поведение можно настроить, обрабатывая DataGridView.DataError события и DataGridView.CellFormatting .

Установка для этого свойства значения, отличного от значения свойства родительского столбца Items , приведет к отмене общего доступа строки, что приведет к выделению дополнительной памяти. Дополнительные сведения о совместном использовании строк см. в статье Масштабирование элемента управления DataGridView в Windows Forms.

См. также раздел

• DataGridView
• Items
• Value
• DisplayMember
• Масштабирование элемента управления DataGridView в Windows Forms