CheckedListBox.ObjectCollection.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 、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。
戻り値
新しく追加された項目のインデックス。
例外
check
パラメーターが、CheckState の有効値ではありません。
注釈
このメソッドは、チェック ボックスに項目を追加します。 並べ替えされていないチェック リスト ボックスの場合、項目は既存の項目リストの末尾に追加されます。 並べ替えられたチェック リスト ボックスの場合、アイテムは並べ替えられた位置に従ってリストに挿入されます。 A は SystemException
、新しい項目を格納するための十分な領域がない場合に発生します。