Control.Controls プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public:
 property System::Windows::Forms::Control::ControlCollection ^ Controls { System::Windows::Forms::Control::ControlCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Control.ControlCollection Controls { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Windows.Forms.Control.ControlCollection

Public ReadOnly Property Controls As Control.ControlCollection

プロパティ値

Control.ControlCollection

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

属性

BrowsableAttribute

例

次のコード例では、 がコレクションのメンバーである場合、派生クラスPanelの から Control.ControlCollection を削除Controlします。 この例では、 で 、Button、および 少なくとも 1 つのRadioButtonコントロールをForm作成Panelしている必要があります。 コントロールが RadioButton コントロールに Panel 追加され、コントロールが Panel に Form追加されます。 ボタンがクリックされると、 という名前 removeButton のラジオ ボタンが から Control.ControlCollection削除されます。

   // 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 );
      }
   }

// 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);
   }
}

' 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(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

注釈

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

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

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

入れ子になったコントロールを Controls 含むフォームのすべてのコントロールを反復処理するには、 プロパティを使用します。 メソッドを GetNextControl 使用して、タブ オーダーで前または次の子コントロールを取得します。 コンテナー コントロールの ActiveControl アクティブなコントロールを取得または設定するには、 プロパティを使用します。

こちらもご覧ください

• Control.ControlCollection
• CreateControlsInstance()
• SuspendLayout()
• ResumeLayout()