Método ContainerProperties.AddMember (Visio)
Adiciona uma forma ou um conjunto de formas ao contêiner.
Sintaxe
expressão. AddMember (pObjectToAdd, addOptions)
Expressão Uma variável que representa um objeto ContainerProperties .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| pObjectToAdd | Obrigatório | DESCONHECIDO | A forma ou formas a serem adicionadas ao contêiner. Pode ser do tipo Forma ou Seleção. |
| addOptions | Obrigatório | VisMemberAddOptions | Determina se o contêiner deve se expandir para conter completamente as formas adicionadas. Deve ser uma das constantes VisMemberAddOptions . |
Valor de retorno
Nothing
Comentários
A passagem de visMemberAddUseResizeSetting ou de visMemberAddDoNotExpand para addOptions pode criar uma situação na qual uma forma seja um membro do contêiner, mas não esteja fisicamente dentro do contêiner. Nesse caso, a forma pode perder sua associação de contêiner em movimentações ou redimensionamentos subsequentes do contêiner ou do membro.
Se o contêiner for uma lista, o AddMember adicionará o objeto especificado ao contêiner da lista, mas não à própria lista. Em outras palavras, a forma será contida pela lista, mas não estará realmente na lista. Isso é comum em formas de contêineres que estejam em uma lista.
Se a propriedade ContainerProperties.LockMembership for True, o Microsoft Visio retornará um erro desabilitado.
Se o parâmetro pObjectToAdd não contiver formas de nível superior na página, o Visio retornará um erro de parâmetro inválido.
O Visio também retornará um erro de parâmetro inválido se você tentar usar o método AddMember para adicionar a forma ou as subformas do contêiner ao contêiner.
O Visio retornará um erro de destino inválido se pObjectToAdd não corresponder aos requisitos de categoria da lista ou do contêiner. É possível atribuir categorias às formas, e os contêineres podem ter categorias obrigatórias e excluídas.
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.
Exemplo
O exemplo de VBA (Visual Basic for Applications) a seguir mostra como usar o método AddMember para adicionar um novo membro (vsoShape) a um contêiner existente (vsoContainerShape) em uma página. O código pressupõe que vsoShape já se sobrepõe a vsoContainerShape.
vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer
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.