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 屬性值的值，會強制該列變成非共享，並分配額外記憶體。 欲了解更多關於資料列共享的資訊，請參閱 Windows 表單 DataGridView 控制項縮放的最佳實務。

另請參閱

• DataGridView
• Items
• Value
• DisplayMember
• Windows 表單 DataGridView 控制項縮放最佳實務