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

新添加项的索引。

示例

下面的代码示例演示如何通过设置CheckOnClick控件SelectionMode和ThreeDCheckBoxes属性来初始化CheckedListBox控件。 该示例使用CheckedListBox控件填充并设置DisplayMemberControl.Name控件的属性。

若要运行该示例，请将以下代码粘贴到包含CheckedListBox名为 CheckedListBox1 的窗体中，并从窗体的构造函数或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

注解

此方法将项添加到列表中。 对于列表，该项将添加到现有项列表的末尾。 对于已排序的列表框，该项将根据其排序位置插入列表中。 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 值。

注解

此方法将项添加到选中的列表框中。 对于未排序的列表框，该项将添加到现有项列表的末尾。 对于已排序的列表框，该项将根据其排序位置插入列表中。 SystemException如果没有足够的空间来存储新项，则会发生。