DataGridViewComboBoxCell.Items プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridViewComboBoxCell.Items プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ドロップダウンリストに表示される選択項目を表すオブジェクトを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property Items As ObjectCollection

Visual Basic (使用法)

Dim instance As DataGridViewComboBoxCell
Dim value As ObjectCollection

value = instance.Items

public virtual ObjectCollection Items { get;
 }

C++

public:
virtual property ObjectCollection^ Items {
    ObjectCollection^ get ();
}

/** @property */
public ObjectCollection get_Items ()

JScript

public function get Items
 () : ObjectCollection

プロパティ値
選択項目を格納している DataGridViewComboBoxCell.ObjectCollection。

解説

このプロパティを使用すると、DataGridViewComboBoxCell に格納されている項目のリストへの参照を取得できます。この参照を使用して、コレクションの項目の追加、項目の削除、および項目数の取得ができます。Items コレクションを使用して実行できるタスクの詳細については、DataGridViewComboBoxCell.ObjectCollection のトピックを参照してください。

Items に文字列を追加する場合は、セル値および表示の両方に追加された各文字列が使用されるため、ValueMember と DisplayMember を設定する必要はありません。

メモ
DataGridViewComboBoxCell では、表示上の値が同じ複数の項目を使用することはできません。

DataSource プロパティを設定する場合、Items プロパティは使用できません。

セルの書式指定済みの値は、常に Items コレクションの値のうちいずれかである必要があります。他の値が割り当てられた場合は、エラーが発生し、セル値がコレクションの最初の項目に戻されます。この動作をカスタマイズするには、DataGridView.DataError イベントと DataGridView.CellFormatting イベントを処理します。

このプロパティを親列の Items プロパティの値以外の値に設定すると、行の共有が強制的に解除され、追加のメモリが割り当てられます。行の共有の詳細については、「Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

使用例

このプロパティに類似している DataGridViewComboBoxColumn.Items プロパティの使用方法を次のコード例に示します。

Visual Basic

Private Shared Sub SetAlternateChoicesUsingItems(
 _
    ByRef comboboxColumn As DataGridViewComboBoxColumn)

    With comboboxColumn
        .Items.AddRange(New String() _
                {"Mr.", "Ms.",
 "Mrs.", "Dr."})
    End With
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

private static void SetAlternateChoicesUsingItems(
    ref DataGridViewComboBoxColumn comboboxColumn)
{
    {
        comboboxColumn.Items.AddRange(
            new string[] { "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;
}

C++

private:
    void SetAlternateChoicesUsingItems(
        DataGridViewComboBoxColumn^% comboboxColumn)
    {
        {
            comboboxColumn->Items->AddRange(
                gcnew array<String^> { "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;
    }