Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Adiciona uma forma ou um conjunto de formas ao contêiner.
Sintaxe
mais simples. 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 seguinte exemplo do Visual Basic for Applications (VBA) 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 sobreponha 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.