Control.Controls プロパティ

コントロール内に格納されているコントロールのコレクションを取得します。

Public ReadOnly Property Controls As Control.ControlCollection
[C#]
public Control.ControlCollection Controls {get;}
[C++]
public: __property Control.ControlCollection* get_Controls();
[JScript]
public function get Controls() : Control.ControlCollection;

プロパティ値

コントロール内に格納されているコントロールのコレクションを表す Control.ControlCollection 。

解説

Control は、コントロールのコレクションの親としての機能を果たします。たとえば、複数のコントロールが Form に追加されると、各コントロールは、 Control クラスから派生した、フォームの Controls プロパティに割り当てられた Control.ControlCollection オブジェクトのメンバになります。

Control.ControlCollection クラスで使用できるメソッドを使用して、 Controls プロパティに割り当てられた Control.ControlCollection オブジェクト内のコントロールを操作できます。

複数のコントロールを親コントロールに追加する場合は、追加するコントロールを初期化する前に SuspendLayout メソッドを呼び出すことをお勧めします。コントロールを親コントロールに追加した後は、 ResumeLayout メソッドを呼び出します。そうすることで、多数のコントロールを持つアプリケーションのパフォーマンスが向上します。

使用例

[Visual Basic, C#, C++] Control が派生クラス Panel の Control.ControlCollection のメンバである場合に、そのコントロールをコレクションから削除する例を次に示します。この例は、 Form 上に Panel 、 Button 、および少なくとも 1 つの RadioButton コントロールが作成されていることを前提にしています。 RadioButton コントロールは Panel コントロールに追加され、 Panel コントロールが Form コントロールに追加されます。ボタンがクリックされると、 radioButton2 という名前のオプション ボタンが Control.ControlCollection から削除されます。

 
' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RadioAddRangeButton) Then
        Panel1.Controls.Remove(RadioAddRangeButton)
    End If
End Sub

[C#] 
// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

[C++] 
// Remove the RadioButton control if it exists.
private:
void removeButton_Click(Object* /*sender*/, System::EventArgs* /*e*/) {
    if (panel1->Controls->Contains(removeButton)) {
        panel1->Controls->Remove(removeButton);
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | Control.ControlCollection | CreateControlsInstance | SuspendLayout | ResumeLayout