Control.ControlCollection.Remove(Control) Método
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.
Remove o controlo especificado da coleção de controlos.
public:
virtual void Remove(System::Windows::Forms::Control ^ value);public virtual void Remove(System.Windows.Forms.Control value);public virtual void Remove(System.Windows.Forms.Control? value);abstract member Remove : System.Windows.Forms.Control -> unit
override this.Remove : System.Windows.Forms.Control -> unitPublic Overridable Sub Remove (value As Control)Parâmetros
- value
- Control
O Control para remover do Control.ControlCollection.
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 um ou mais RadioButton controlos num Form. Os RadioButton controlos são adicionados ao Panel controlo, e o controlo Panel é adicionado ao Form. Quando o botão é clicado, o botão de rádio nomeado radioButton2 é 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
Quando a Control é removido da coleção de controlos, todos os controlos subsequentes são movidos uma posição para cima na coleção.
Também pode remover a Control usando o RemoveAt método, ou remover todos os controlos usando o Clear método.
Para adicionar novos Control objetos à coleção, utilize os Add métodos ou AddRange .
Notas para Herdeiros
Ao substituir Remove(Control) uma classe derivada, certifique-se de chamar o método da Remove(Control) classe base para garantir que o controlo é removido da coleção.
