Control.ControlCollection.Clear Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Odebere všechny ovládací prvky z kolekce.
public:
virtual void Clear();
public virtual void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()
Implementuje
Příklady
Následující příklad kódu odebere všechny Control objekty v Control.ControlCollection odvozené třídě Panel. Příklad vyžaduje, abyste vytvořili ovládací Panelprvek , aspoň Buttonjeden další ovládací prvek na .Form Ostatní ovládací prvky jsou přidány do Panel ovládacího prvku a přidány Panel do .Form Po kliknutí na tlačítko se z panelu odeberou všechny ovládací prvky obsažené v panelu Control.ControlCollection.
// Clear all the controls in the Panel.
private:
void clearButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
panel1->Controls->Clear();
}
// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
panel1.Controls.Clear();
}
' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles ClearButton.Click
Panel1.Controls.Clear()
End Sub
Poznámky
Pomocí Clear metody můžete odebrat celou kolekci ovládacích prvků z nadřazeného ovládacího prvku.
Pokud chcete odebrat jednotlivý ovládací prvek z kolekce, použijte metody Remove nebo RemoveAt metody.
Důležité
Clear Volání metody neodebere ovládací úchyty z paměti. Je nutné explicitně volat metodu Dispose , aby nedošlo k nevracení paměti.
Pokud chcete do kolekce přidat nové Control objekty, použijte metody Add nebo AddRange metody.
Poznámky pro dědice
Při přepsání Clear() v odvozené třídě nezapomeňte volat metodu základní třídy Clear() , aby se zajistilo, že všechny ovládací prvky budou odebrány z kolekce.