CheckedListBox.ObjectCollection.Add メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

オーバーロード

Add(Object, Boolean)	追加するオブジェクトとそのオブジェクトがチェックされているかどうかを指定して、CheckedListBox の項目のリストに項目を追加します。
Add(Object, CheckState)	追加するオブジェクトとチェックされた値の初期状態を指定し、CheckedListBox のリストに項目を追加します。

Add(Object, Boolean)

追加するオブジェクトとそのオブジェクトがチェックされているかどうかを指定して、CheckedListBox の項目のリストに項目を追加します。

public:
 int Add(System::Object ^ item, bool isChecked);

public int Add (object item, bool isChecked);

override this.Add : obj * bool -> int

Public Function Add (item As Object, isChecked As Boolean) As Integer

パラメーター

item

Object

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

isChecked

Boolean

項目をチェックする場合は true。それ以外の場合は false。

戻り値

Int32

新しく追加された項目のインデックス。

例

次のコード例では、コントロールの初期化に CheckedListBox 、SelectionMode、およびThreeDCheckBoxesプロパティをCheckOnClick設定します。 この例では、コントロールを CheckedListBox 設定し、コントロールの DisplayMember プロパティに Control.Name 設定します。

この例を実行するには、CheckListBox1 という名前のフォームに次のコードをCheckedListBox貼り付け、フォームのコンストラクターまたはLoadメソッドからメソッドを呼び出InitializeCheckListBoxします。

   // This method initializes CheckedListBox1 with a list of all 
   // the controls on the form. It sets the selection mode
   // to single selection and allows selection with a single click.
   // It adds itself to the list before adding itself to the form.
internal:
   System::Windows::Forms::CheckedListBox^ CheckedListBox1;

private:
   void InitializeCheckedListBox()
   {
      this->CheckedListBox1 = gcnew CheckedListBox;
      this->CheckedListBox1->Location = System::Drawing::Point( 40, 90 );
      this->CheckedListBox1->CheckOnClick = true;
      this->CheckedListBox1->Name = "CheckedListBox1";
      this->CheckedListBox1->Size = System::Drawing::Size( 120, 94 );
      this->CheckedListBox1->TabIndex = 1;
      this->CheckedListBox1->SelectionMode = SelectionMode::One;
      this->CheckedListBox1->ThreeDCheckBoxes = true;
      System::Collections::IEnumerator^ myEnum = this->Controls->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Control^ aControl = safe_cast<Control^>(myEnum->Current);
         this->CheckedListBox1->Items->Add( aControl, false );
      }

      this->CheckedListBox1->DisplayMember = "Name";
      this->CheckedListBox1->Items->Add( CheckedListBox1 );
      this->Controls->Add( this->CheckedListBox1 );
   }

// This method initializes CheckedListBox1 with a list of all 
// the controls on the form. It sets the selection mode
// to single selection and allows selection with a single click.
// It adds itself to the list before adding itself to the form.

internal System.Windows.Forms.CheckedListBox CheckedListBox1;

private void InitializeCheckedListBox()
{
    this.CheckedListBox1 = new CheckedListBox();
    this.CheckedListBox1.Location = new System.Drawing.Point(40, 90);
    this.CheckedListBox1.CheckOnClick = true;
    this.CheckedListBox1.Name = "CheckedListBox1";
    this.CheckedListBox1.Size = new System.Drawing.Size(120, 94);
    this.CheckedListBox1.TabIndex = 1;
    this.CheckedListBox1.SelectionMode = SelectionMode.One;
    this.CheckedListBox1.ThreeDCheckBoxes = true;

    foreach ( Control aControl in this.Controls )
    {
        this.CheckedListBox1.Items.Add(aControl, false);
    }

    this.CheckedListBox1.DisplayMember = "Name";
    this.CheckedListBox1.Items.Add(CheckedListBox1);
    this.Controls.Add(this.CheckedListBox1);
}

' This method initializes CheckedListBox1 with a list of all the controls
' on the form. It sets the selection mode to single selection and
' allows selection with a single click. It adds itself to the list before 
' adding itself to the form.
Friend WithEvents CheckedListBox1 As System.Windows.Forms.CheckedListBox

Private Sub InitializeCheckedListBox()
    Me.CheckedListBox1 = New CheckedListBox
    Me.CheckedListBox1.Location = New System.Drawing.Point(40, 90)
    Me.CheckedListBox1.CheckOnClick = True
    Me.CheckedListBox1.Name = "CheckedListBox1"
    Me.CheckedListBox1.Size = New System.Drawing.Size(120, 94)
    Me.CheckedListBox1.TabIndex = 1
    Me.CheckedListBox1.SelectionMode = SelectionMode.One
    Me.CheckedListBox1.ThreeDCheckBoxes = True

    Dim aControl As Control
    For Each aControl In Me.Controls
        Me.CheckedListBox1.Items.Add(aControl, False)
    Next

    Me.CheckedListBox1.DisplayMember = "Name"
    Me.CheckedListBox1.Items.Add(CheckedListBox1)
    Me.Controls.Add(Me.CheckedListBox1)
End Sub

注釈

このメソッドは、リストに項目を追加します。 リストの場合、項目は既存の項目リストの末尾に追加されます。 並べ替えられたチェック リスト ボックスの場合、アイテムは並べ替えられた位置に従ってリストに挿入されます。 A は SystemException 、新しい項目を格納するための十分な領域がない場合に発生します。

Add(Object, CheckState)

追加するオブジェクトとチェックされた値の初期状態を指定し、CheckedListBox のリストに項目を追加します。

public:
 int Add(System::Object ^ item, System::Windows::Forms::CheckState check);

public int Add (object item, System.Windows.Forms.CheckState check);

override this.Add : obj * System.Windows.Forms.CheckState -> int

Public Function Add (item As Object, check As CheckState) As Integer

パラメーター

item

Object

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

check

CheckState

チェックされた部分の項目の初期 CheckState。

戻り値

Int32

新しく追加された項目のインデックス。

例外

InvalidEnumArgumentException

check パラメーターが、CheckState の有効値ではありません。

注釈

このメソッドは、チェック ボックスに項目を追加します。 並べ替えされていないチェック リスト ボックスの場合、項目は既存の項目リストの末尾に追加されます。 並べ替えられたチェック リスト ボックスの場合、アイテムは並べ替えられた位置に従ってリストに挿入されます。 A は SystemException 、新しい項目を格納するための十分な領域がない場合に発生します。