Control.Controls Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém a coleção de controles contidos no controle.

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

Valor da propriedade

Control.ControlCollection

Um Control.ControlCollection que representa a coleção de controles contidos no controle.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir remove um Control do Control.ControlCollection da classe Panel derivada se ele for um membro da coleção. O exemplo requer que você tenha criado um , um PanelButtone pelo menos um RadioButton controle em um Form. Os RadioButton controles são adicionados ao Panel controle e o Panel controle adicionado ao Form. Quando o botão é clicado, o botão de opção chamado removeButton é removido do 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

Comentários

Um Control pode atuar como pai de uma coleção de controles. Por exemplo, quando vários controles são adicionados a um , cada um Formdos controles é um membro do Control.ControlCollection atribuído à Controls propriedade do formulário, que é derivado da Control classe .

Você pode manipular os controles no Control.ControlCollection atribuído à Controls propriedade usando os métodos disponíveis na Control.ControlCollection classe .

Ao adicionar vários controles a um controle pai, é recomendável que você chame o SuspendLayout método antes de inicializar os controles a serem adicionados. Depois de adicionar os controles ao controle pai, chame o ResumeLayout método . Isso aumentará o desempenho dos aplicativos com muitos controles.

Use a Controls propriedade para iterar todos os controles de um formulário, incluindo controles aninhados. Use o GetNextControl método para recuperar o controle filho anterior ou próximo na ordem de tabulação. Use a ActiveControl propriedade para obter ou definir o controle ativo de um controle de contêiner.

Confira também

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