Share via


Método Page.AutoConnectMany (Visio)

Desenha automaticamente várias conexões nas direções especificadas entre as formas especificadas. Retorna o número de formas conectadas.

Sintaxe

expression. AutoConnectMany( _FromShapeIDs()_ , _ToShapeIDs()_ , _PlacementDirs()_ , _[Connector]_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
FromShapeIDs() Obrigatório Long Uma matriz de identificadores das formas a partir das quais será desenhada uma conexão.
ToShapeIDs() Obrigatório Long Uma matriz de identificadores das formas nas quais será desenhada uma conexão.
PlacementDirs() Obrigatório Long Uma matriz de constantes VisAutoConnectDir que representam as direções nas quais desenhar as conexões. Consulte comentários para os valores possíveis.
Connector Opcional [DESCONHECIDO] O conector a ser usado. Pode ser um objeto Mestre, MestreShortcut, Shape ou IDataObject .

Valor de retorno

Long

Comentários

Para o parâmetro PlacementDirs(), passe uma matriz de valores da enumeração VisAutoConnectDir para especificar as direções de conexão (isto é, onde localizar as formas conectadas com relação às formas primárias). Os valores possíveis para PlacementDirs() são os seguintes.

Constant Valor Descrição
visAutoConnectDirDown 2 Conectar à parte inferior.
visAutoConnectDirLeft 3 Conectar à esquerda.
visAutoConnectDirNone 0 Conectar sem relocar as formas.
visAutoConnectDirRight 4 Conectar à direita.
visAutoConnectDirUp 1 Conectar à parte superior.

Chamar o método AutoConnectMany é equivalente a chamar o método Shape.AutoConnect várias vezes.

Você pode incluir a mesma forma várias vezes em cada matriz que você passa como um parâmetro. Você não pode usar o método AutoConnectMany reppara conectar uma forma a si mesma.

Se uma operação AutoConnectMany determinada falhar ou for inválida, o Microsoft Visio a ignorará e processará o item seguinte em cada uma das matrizes de parâmetro. AutoConnectMany retorna o número total de itens processados com êxito.

Se as matrizes de parâmetros não contiverem o mesmo número de valores, o Visio retornará um erro de Parâmetro Inválido.

O valor do parâmetro Connector opcional deve ser um objeto que faça referência a uma forma roteável unidimensional. Se você não passar um valor para Conector , o Visio usará o conector dinâmico padrão.

Se você usar a interface IDataObject para passar uma seleção de formas para Conector , o Visio usará apenas a primeira forma. Se Connector não for um objeto do Visio, o Visio retornará um erro de parâmetro inválido. Se Connector não for uma forma que corresponda ao contexto do método, o Visio retornará um erro de origem inválida.

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.