Control.Controls プロパティ

定義

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

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

属性

次のコード例では、 がコレクションのメンバーである場合、派生クラスPanelの から Control.ControlCollection を削除Controlします。 この例では、 で 、Button、および 少なくとも 1 つのRadioButtonコントロールをForm作成Panelしている必要があります。 コントロールが RadioButton コントロールに Panel 追加され、コントロールが PanelForm追加されます。 ボタンがクリックされると、 という名前 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 アクティブなコントロールを取得または設定するには、 プロパティを使用します。

適用対象

こちらもご覧ください