Control.Controls Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém a coleção de controlos contida no controlo.
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.ControlCollectionPublic ReadOnly Property Controls As Control.ControlCollectionValor de Propriedade
A representa Control.ControlCollection o conjunto de controlos contidos no controlo.
- Atributos
Exemplos
O exemplo de código seguinte remove a Control do Control.ControlCollection da classe Panel derivada se for membro da coleção. O exemplo exige que tenhas criado um Panel, um Button, e pelo menos um RadioButton controlo sobre um Form. O RadioButton (s) controlo(s) são adicionados ao Panel controlo, e o Panel controlo adicionado ao Form. Quando o botão é clicado, o botão de rádio nomeado 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
Observações
A Control pode atuar como pai de um conjunto de controlos. Por exemplo, quando vários controlos são adicionados a um Form, cada um dos controlos é um membro do Control.ControlCollection atribuído à Controls propriedade da forma, que é derivada da Control classe.
Pode manipular os controlos na Control.ControlCollection propriedade atribuída Controls à propriedade usando os métodos disponíveis na Control.ControlCollection classe.
Ao adicionar vários controlos a um controlo pai, recomenda-se que chame o SuspendLayout método antes de inicializar os controlos a serem adicionados. Depois de adicionar os controlos ao controlo pai, chama o ResumeLayout método. Ao fazê-lo, aumentará o desempenho das aplicações com muitos controlos.
Use a Controls propriedade para iterar por todos os controlos de um formulário, incluindo controlos aninhados. Use o GetNextControl método para recuperar o controlo filho anterior ou seguinte na ordem de tabulação. Use a ActiveControl propriedade para obter ou definir o controlo ativo de um controlo de contentor.