ComboBox.ObjectCollection.Add(Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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のSortedプロパティがtrueに設定されている場合、項目はアルファベット順にリストに挿入されます。 それ以外の場合、項目はリストの末尾に挿入されます。
項目の視覚的表現がコンボ ボックスに表示されます。 このコンテンツ表現は、 DisplayMember プロパティによって指定されます。
DisplayMember プロパティがnull場合は、コンボ ボックスに表示される文字列を取得するために項目のToString メソッドが呼び出されます。それ以外の場合は、DisplayMember プロパティで指定された格納されたオブジェクトのプロパティが表示されます。 新しい項目を格納するための空き領域が不足している場合は、 SystemException が発生します。 コンボ ボックスに項目のセットを追加するには、 AddRange メソッドを使用することをお勧めします。
Add メソッドを使用して多数の項目をコンボ ボックスに追加する場合は、BeginUpdate メソッドを使用して、追加中に再描画を中断し、EndUpdate メソッドを使用して再描画を再開します。
Insertメソッドを使用して、項目を追加するリスト内の場所を指定できます。 オブジェクトがコレクションに追加されると、 ComboBox はオブジェクトの ToString メソッドを呼び出して、リストに表示する文字列を取得します。