DataGridViewComboBoxCell.Items Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewComboBoxCell.cs

Возвращает объекты, представляющие выделение, отображаемое в раскрывающемся списке.

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