CheckedListBox.ObjectCollection.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет элемент в список позиций 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
.
Возвращаемое значение
Индекс только что добавленного элемента.
Примеры
В следующем примере кода демонстрируется инициализация CheckedListBox элемента управления путем задания CheckOnClickSelectionModeсвойств и 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, указывая объект для добавления и начальное отмеченное значение.
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 для отмеченной части элемента.
Возвращаемое значение
Индекс только что добавленного элемента.
Исключения
Параметр check
не является допустимым значением состояния CheckState.
Комментарии
Этот метод добавляет элемент в флажок списка. Если флажок не установлен, элемент добавляется в конец существующего списка элементов. Для отсортированного флажка элемент вставляется в список в соответствии с отсортированной позицией. Возникает SystemException
, если для хранения нового элемента недостаточно места.