VisualCollection.Insert(Int32, Visual) Método

Definição

Insere um elemento 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 baseado em zero no qual o valor deve ser inserido.

visual
Visual

A Visual inserção VisualCollectionno .

Exceções

index é menor que zero ou maior que Count.

Comentários

Se Count já for igual, a capacidade do valor será aumentada antes da Capacity inserção VisualCollectiondo novoVisual. Se index for igual a Count, visual será adicionado ao final de VisualCollection. Todos os objetos visuais existentes que são 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 VisualCollectione do 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 o uso e AddVisualChild os 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