Partilhar via


VisualCollection.Insert(Int32, Visual) Método

Definição

Insere um elemento no VisualCollection, no índice especificado.

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 -> unit
Public Sub Insert (index As Integer, visual As Visual)

Parâmetros

index
Int32

O índice de base zero no qual o valor deve ser inserido.

visual
Visual

O Visual a ser inserido no VisualCollection.

Exceções

index é menor que zero ou maior que Count.

Comentários

Se Count já for Capacityigual, a capacidade do VisualCollection novo será aumentada antes que o novo Visual seja inserido. Se index for igual a Count, visual será adicionado ao final de VisualCollection. Todos os objetos visuais existentes iguais ou maiores que index são deslocados para acomodar o novo Visuale seus valores de índice são atualizados.

O Insert método também configura a relação pai-filho entre o visual pai, que é o proprietário do VisualCollection, e o filho visual.

Se você precisar de um maior controle de baixo nível sobre a implementação de armazenamento subjacente de objetos filho visuais, considere usar e AddVisualChild RemoveVisualChild métodos. Ao usar esses métodos, você define sua própria implementação de armazenamento e não usa VisualCollection.

Aplica-se a