Partilhar via


Método Shape.GluedShapes (Visio)

Retorna uma matriz que contém os identificadores das formas coladas a uma forma.

Sintaxe

expression. GluedShapes( _Flags_ , _CategoryFilter_ , _pOtherConnectedShape_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Flags Obrigatório VisGluedShapesFlags A dimensionalidade e a direcionalidade dos pontos de conexão das formas a serem retornadas.
CategoryFilter Obrigatório String A categoria de formas a ser retornada. Consulte Comentários para obter mais informações
pOtherConnectedShape Opcional Formato A forma adicional à qual as formas retornadas também devem ser coladas.

Valor de retorno

Long()

Comentários

Flags deve ser uma das constantes VisGluedShapesFlags a seguir.

Constant Valor Descrição
visGluedShapesAll1D 0 Retorne todas as formas 1D coladas a essa forma.
visGluedShapesIncoming1D 1 Retorne formas 1D cujos pontos de extremidade estão colados a essa forma.
visGluedShapesOutgoing1D 2 Retorne formas 1D cujos pontos de início estão colados a essa forma.
visGluedShapesAll2D 3 Retorne todas as formas 2D coladas a essa forma e todas as formas 2D às quais essa forma está colada.
visGluedShapesIncoming2D 4 Se o objeto de origem for uma forma 1D, retorne a forma 2D à qual o ponto de partida está colado. Se o objeto de origem for uma forma 2D, retorne as formas 2D coladas a essa forma.
visGluedShapesOutgoing2D 5 Se o objeto de origem for uma forma 1D, retorne a forma 2D à qual o ponto de extremidade está colado. Se o objeto de origem for uma forma 2D, retorne as formas 2D às quais essa forma está colada.

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.

Os pontos de conexão com direcionalidade dupla () são identificados como de entrada ou de saída com base na maneira que são usadas em uma determinada conexão.

O método GluedShapes falhará se o objeto de origem for uma parte de um mestre ou guia. As guias são excluídas de qualquer lista de formas retornada.

Se você especificar uma forma inválida para pOtherConnectedShape , o Microsoft Visio retornará um erro de parâmetro inválido.

GluedShapes retornará uma matriz vazia se não houver formas qualificadoras a serem retornadas.

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.