Método Shape.AutoConnect (Visio)

Desenha uma conexão automaticamente na direção especificada entre a forma e uma outra forma na página de desenho.

Sintaxe

expression. AutoConnect( _ToShape_ , _PlacementDir_ , _Connector_ )

Expressão Uma expressão que retorna um objeto Shape .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
ToShape	Obrigatório	[IVSHAPE]	A forma para a qual você deseja desenhar a conexão.
PlacementDir	Obrigatório	VisAutoConnectDir	A direção em que deve ser desenhada a conexão. Consulte Comentários para obter os valores possíveis.
Connector	Opcional	[DESCONHECIDO]	O conector a ser usado.

Valor de retorno

Nada

Comentários

O método AutoConnect permite desenhar automaticamente conexões entre as formas na página de desenho e, ao mesmo tempo, especificar a direção da conexão e, opcionalmente, o conector.

Para o parâmetro ToShape, passe o objeto Shape para o qual deseja desenhar a conexão.

Para o parâmetro PlacementDir, passe um valor da enumeração VisAutoConnectDir para especificar a direção da conexão; ou seja, onde localizar a forma conectada em relação à forma primária. Os valores possíveis para PlacementDir 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.

Se sua solução do Visual Studio incluir a referência Microsoft.Office.Interop.Visio , este método será mapeado para os seguintes tipos:

• Microsoft.Office.Interop.Visio.IVShape.AutoConnect(Microsoft.Office.Interop.Visio.Shape, Microsoft.Office.Interop.Visio.VisAutoConnectDir, objeto)

Exemplo

A macro a seguir do Microsoft Visual Basic for Applications (VBA) mostra como usar o método AutoConnect para desenhar uma conexão entre duas formas de fluxograma, uma forma de decisão e uma forma de processo, usando uma terceira forma, um conector dinâmico, todas elas adicionadas a uma página de desenho vazia do estêncil Formas de Fluxograma Básico (Unidades Americanas).

Como o exemplo chama o método na forma de decisão, o Visio desenha o conector a partir dessa forma até a forma de processo. Como o valor enumerado visAutoConnectDirRight para o parâmetro PlacementDir é passado ao método, o Visio posiciona a forma de processo automaticamente à direita da forma de decisão na página de desenho, independentemente de seu local anterior.

Public Sub AutoConnect_Example() 
 
    Dim vsoShape1 As Visio.Shape 
    Dim vsoShape2 As Visio.Shape 
    Dim vsoConnectorShape As Visio.Shape 
 
    Set vsoShape1 = Visio.ActivePage.Shapes("Decision") 
    Set vsoShape2 = Visio.ActivePage.Shapes("Process") 
    Set vsoConnectorShape = Visio.ActivePage.Shapes("Dynamic connector") 
 
    vsoShape1.AutoConnect vsoShape2, visAutoConnectDirRight, vsoConnectorShape 
 
End Sub

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.