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.