CheckedListBox.ObjectCollection.Add Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá položku do seznamu položek pro položku CheckedListBox.

Přetížení

Name	Description
Add(Object, Boolean)	Přidá položku do seznamu položek pro , CheckedListBoxurčení objektu, který se má přidat a zda je zaškrtnuté.
Add(Object, CheckState)	Přidá položku do seznamu položek pro položku CheckedListBox, určení objektu, který se má přidat, a počáteční zaškrtnutou hodnotu.

Add(Object, Boolean)

Zdroj:

CheckedListBox.ObjectCollection.cs

Přidá položku do seznamu položek pro , CheckedListBoxurčení objektu, který se má přidat a zda je zaškrtnuté.

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

Parametry

item

Object

Objekt představující položku, kterou chcete přidat do kolekce.

isChecked

Boolean

truepro kontrolu položky; v opačném případě . false

Návraty

Int32

Index nově přidané položky.

Příklady

Následující příklad kódu ukazuje inicializaci CheckedListBox ovládacího prvku nastavením CheckOnClick, SelectionModea ThreeDCheckBoxes vlastnosti. Příklad naplní CheckedListBox ovládacími prvky a nastaví DisplayMember vlastnost Control.Name ovládacího prvku.

Chcete-li spustit příklad, vložte následující kód do formuláře obsahující pojmenovaný CheckedListBox CheckedListBox1 a zavolejte InitializeCheckListBox metodu z konstruktoru nebo Load metody formuláře.

   // 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

Poznámky

Tato metoda přidá položku do seznamu. Pro seznam se položka přidá na konec existujícího seznamu položek. U seřazeného zaškrtávacího seznamu se položka vloží do seznamu podle jeho seřazené pozice. K SystemException chybě dochází v případě, že není k dispozici dostatek místa pro uložení nové položky.

Add(Object, CheckState)

Zdroj:

CheckedListBox.ObjectCollection.cs

Přidá položku do seznamu položek pro položku CheckedListBox, určení objektu, který se má přidat, a počáteční zaškrtnutou hodnotu.

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

Parametry

item

Object

Objekt představující položku, kterou chcete přidat do kolekce.

check

CheckState

Iniciála CheckState pro zaškrtnutou část položky.

Návraty

Int32

Index nově přidané položky.

Výjimky

InvalidEnumArgumentException

Parametr check není jednou z platných CheckState hodnot.

Poznámky

Tato metoda přidá položku do zaškrtávacího seznamu. U neseřazeného zaškrtávacího seznamu se položka přidá na konec existujícího seznamu položek. U seřazeného zaškrtávacího seznamu se položka vloží do seznamu podle jeho seřazené pozice. K SystemException chybě dochází v případě, že není k dispozici dostatek místa pro uložení nové položky.