Método ContainerProperties.InsertListMember (Visio)

  • Artigo

Adiciona uma forma ou um conjunto de formas à lista no contêiner.

Sintaxe

expressão. InsertListMember (ObjectToInsert, Position)

Expressão Uma variável que representa um objeto ContainerProperties .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
ObjectToInsert Obrigatório [DESCONHECIDO] O objeto ou a seleção a ser inserida na lista. Pode ser um objeto Shape ou Selection .
Posição Obrigatório Long O ponto de inserção na lista, que é baseada em um.

Valor de retorno

Nothing

Comentários

Se o contêiner não estiver em uma lista, o Microsoft Visio retornará um erro de origem inválida.

Se o parâmetro ObjectToInsert contiver alguma forma que não seja de nível superior ou se a lista estiver bloqueada, o Visio retornará um erro de parâmetro inválido. Os seguintes objetos não podem ser inseridos em uma lista:

  • Outra lista.

  • Um texto explicativo.

  • Conectores roteáveis.

  • Formas cujas células PinX ou PinY têm a função BOUND, GUARD ou SETATREF aplicada.

  • Um membro de outra lista bloqueada.

O Visio ignora formas no ObjectToInsert que já sejam membros da lista.

Para inserir antes do primeiro item na lista, passe 1 para o parâmetro Position. Para inserir no final da lista, passe um valor de Position maior ou igual ao valor da conta da lista mais 1. Se você passar uma posição fora do intervalo, o Visio escolherá a posição válida mais próxima.

Se ObjectToInsert não corresponder aos requisitos de categoria para listas, o Visio retornará um erro.

As categorias são cadeias de caracteres definidas pelo usuário que você pode usar para categorizar formas e, assim, restringir a associação em um contêiner. Você pode definir categorias na célula User.msvShapeCategories do ShapeSheet para uma forma. Você pode definir várias categorias para uma forma separando-as com ponto-e-vírgulas.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.