ComboBox.ObjectCollection.AddRange(Object[]) メソッド

定義

ComboBox の項目のリストに、項目の配列を追加します。Adds an array of items to the list of items for a ComboBox.

public:
 void AddRange(cli::array <System::Object ^> ^ items);
public void AddRange (object[] items);
member this.AddRange : obj[] -> unit
Public Sub AddRange (items As Object())

パラメーター

items
Object[]

リストに追加するオブジェクトの配列。An array of objects to add to the list.

例外

items パラメーターの項目が null でした。An item in the items parameter was null.

次のコード例では ComboBox 、text プロパティを設定し、メソッドを使用してを設定することによって、コントロールを初期化する方法を示し AddRange ComboBox ます。The following code example demonstrates how to initialize a ComboBox control by setting the text property and using the AddRange method to populate the ComboBox. また、イベントの処理についても説明 DropDown します。It also demonstrates handling the DropDown event. この例を実行するには、フォームに次のコードを貼り付け、 InitializeComboBox フォームのコンストラクターまたはメソッドからメソッドを呼び出し Load ます。To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

注釈

Sortedのプロパティ ComboBox が true に設定されている場合、項目はアルファベット順にリストに挿入されます。If the Sorted property of the ComboBox is set to true, the items are inserted into the list alphabetically. それ以外の場合、項目は配列内に出現する順序で挿入されます。Otherwise, the items are inserted in the order they occur within the array. 通常、このメソッドにはオブジェクトの配列が渡され String ますが、任意の型のオブジェクトの配列をこのメソッドに渡すことができます。This method is typically passed an array of String objects, but an array of any type of object can be passed to this method. オブジェクトがコレクションに追加されると、メソッドはオブジェクトのメソッドを呼び出して、 ToString リストに表示する文字列を取得します。When an object is added to the collection, the method calls the object's ToString method to obtain the string to display in the list. このメソッドを使用してコレクションに項目を追加する場合、 BeginUpdate パフォーマンスを最適化するためにメソッドとメソッドを呼び出す必要はありません EndUpdateWhen using this method to add items to the collection, you do not need to call the BeginUpdate and EndUpdate methods to optimize performance.

適用対象