VisualCollection.Insert(Int32, Visual) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.