DataGridViewComboBoxCell.Items プロパティ

定義

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

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

属性

次のコード例では、 プロパティの使用方法を 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追加される場合、追加された各文字列は値とDisplayMember表示の両方に使用されるため、 をValueMember設定する必要はありません。

注意

DataGridViewComboBoxCell は、同じ表示値を持つ複数の項目の使用をサポートしていません。

プロパティが DataSource 設定されている場合は、 プロパティを Items 使用できません。

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

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

適用対象

こちらもご覧ください