VisualCollection.Insert(Int32, Visual) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een element in de VisualCollection opgegeven index in.
public:
void Insert(int index, System::Windows::Media::Visual ^ visual);public void Insert(int index, System.Windows.Media.Visual visual);member this.Insert : int * System.Windows.Media.Visual -> unitPublic Sub Insert (index As Integer, visual As Visual)Parameters
- index
- Int32
De op nul gebaseerde index waarop de waarde moet worden ingevoegd.
- visual
- Visual
De Visual invoegpositie in de VisualCollection.
Uitzonderingen
index is kleiner dan nul of groter dan Count.
Opmerkingen
Als Count deze al gelijk is Capacityaan, wordt de capaciteit van de VisualCollection nieuwe verhoogd voordat de nieuwe Visual wordt ingevoegd. Als index dit gelijk is aan Count, visual wordt toegevoegd aan het einde van VisualCollection. Bestaande visuele objecten die gelijk zijn aan of groter zijn dan index worden verschoven om tegemoet te komen aan de nieuwe Visualobjecten en de bijbehorende indexwaarden worden bijgewerkt.
Met Insert de methode wordt ook de relatie tussen bovenliggende en onderliggende elementen ingesteld tussen de bovenliggende visual, de eigenaar van de VisualCollectionen het onderliggende visualelement.
Als u meer controle op laag niveau nodig hebt over de onderliggende opslag-implementatie van onderliggende visuele objecten, kunt u overwegen de AddVisualChild en RemoveVisualChild methoden te gebruiken. Wanneer u deze methoden gebruikt, definieert u uw eigen opslag-implementatie en gebruikt VisualCollectionu deze niet.
