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
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. Tem de 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 devolve um erro Desativado.
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 devolve um erro de Destino Inválido se pObjectToAdd não corresponder aos requisitos de categoria da lista ou do contentor. É 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 Visual Basic for Applications (VBA) seguinte mostra como utilizar o método AddMember para adicionar um novo membro (vsoShape) a um contentor existente (vsoContainerShape) numa 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.