ComboBox.ObjectCollection.Add(Object) メソッド

定義

ComboBox の項目のリストに項目を追加します。

public:
 int Add(System::Object ^ item);
public int Add (object item);
member this.Add : obj -> int
Public Function Add (item As Object) As Integer

パラメーター

item
Object

コレクションに追加する項目を表すオブジェクト。

戻り値

コレクション内のアイテムの 0 から始まるインデックスです。

例外

item パラメーターは null でした。

注釈

このメソッドは、コンボ ボックスに項目を追加します。 の ComboBox プロパティが Sortedtrue設定されている場合、項目はアルファベット順にリストに挿入されます。 それ以外の場合、項目はリストの末尾に挿入されます。

項目の視覚的な表現がコンボ ボックスに表示されます。 このコンテンツ表現は、 プロパティによって DisplayMember 指定されます。 プロパティが DisplayMember の場合、 nullコンボ ボックスに表示される文字列を取得するために項目の ToString メソッドが呼び出されます。それ以外の場合は、 プロパティで DisplayMember 指定された格納オブジェクトの プロパティが表示されます。 SystemExceptionは、新しい項目を格納するための空き領域が不足している場合に発生します。 コンボ ボックスに項目のセットを追加するには、 メソッドを使用 AddRange することをお勧めします。 メソッドを Add 使用して複数の項目をコンボ ボックスに追加する場合は、 メソッドを BeginUpdate 使用して、追加中に再描画を中断し、メソッドを EndUpdate 使用して再描画を再開します。 メソッドを Insert 使用して、項目が追加されるリスト内の場所を指定できます。 オブジェクトがコレクションに追加されると、 ComboBox は オブジェクトの ToString メソッドを呼び出して、リストに表示する文字列を取得します。

適用対象

こちらもご覧ください