VisualCollection.Insert(Int32, Visual) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Insere um elemento no VisualCollection í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 baseado em zero no qual o valor deve ser inserido.
- visual
- Visual
O Visual para inserir no VisualCollection.
Exceções
index é menor que zero ou maior que Count.
Observações
Se Count já for Capacityigual a , a capacidade de é VisualCollection aumentada antes de o novo Visual ser inserido. Se index for igual a Count, visual é somado ao final de VisualCollection. Quaisquer objetos visuais existentes que sejam iguais ou superiores index são deslocados para acomodar o novo Visual, e os seus valores de índice são atualizados.
O Insert método também estabelece a relação pai-filho entre o visual parental, que é o proprietário do VisualCollection, e o filho visual.
Se precisar de maior controlo de baixo nível sobre a implementação de armazenamento subjacente dos objetos visuais filhos, considere usar os AddVisualChild métodos e.RemoveVisualChild Quando utiliza estes métodos, define a sua própria implementação de armazenamento e não utiliza VisualCollection.
