CheckedListBox.ObjectCollection.Add Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Добавляет элемент в список элементов для CheckedListBoxэлемента.

Перегрузки

Имя	Описание
Add(Object, Boolean)	Добавляет элемент в список элементов для CheckedListBoxобъекта, указывая добавляемый объект и проверяемый объект.
Add(Object, CheckState)	Добавляет элемент в список элементов для элемента, указывающего объект для CheckedListBoxдобавления и начального проверяемого значения.

Add(Object, Boolean)

Исходный код:

CheckedListBox.ObjectCollection.cs

Добавляет элемент в список элементов для 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 элемента управления путем задания CheckOnClickсвойств SelectionModeи ThreeDCheckBoxes свойств. Пример заполняет CheckedListBox элементы управления и задает DisplayMember свойство Control.Name элемента управления.

Чтобы запустить пример, вставьте следующий код в форму CheckedListBox с именем CheckedListBox1 и вызовите InitializeCheckListBox метод из конструктора или Load метода формы.

   // 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.ObjectCollection.cs

Добавляет элемент в список элементов для элемента, указывающего объект для 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 , если недостаточно места для хранения нового элемента.