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 コントロールのスケーリングに関するベスト プラクティス