Método Shape.GluedShapes (Visio)

Retorna uma matriz que contém os identificadores das formas associadas 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 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 que estão coladas a essa forma.
visGluedShapesIncoming1D 1 Retornam formas 1D cujos pontos de extremidade estão colados a essa forma.
visGluedShapesOutgoing1D 2 Retornar formas 1D cujos pontos iniciais são colados a essa forma.
visGluedShapesAll2D 3 Retorne todas as formas 2D associadas a essa forma e todas as formas 2D às quais essa forma está associada.
visGluedShapesIncoming2D 4 Se o objeto de origem for uma forma 1D, retorne a forma 2D à qual o ponto inicial está associado. Se o objeto de origem for uma forma 2D, retorne as formas 2D que estão associadas a essa forma.
visGluedShapesOutgoing2D 5 Se o objeto de origem for uma forma 1D, retorne a forma 2D à qual o ponto final está associado. Se o objeto de origem for uma forma 2D, retorne as formas 2D às quais essa forma está associada.

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.