Método Shape.AutoConnect (Visio)

Dibuja automáticamente una conexión en la dirección especificada entre la forma y otra forma de la página de dibujo.

Sintaxis

expresión. AutoConnect( _ToShape_ , _PlacementDir_ , _Connector_ )

Expresión Expresión que devuelve un objeto Shape .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
ToShape	Obligatorio	[IVSHAPE]	Forma hasta la que se dibujará la conexión.
PlacementDir	Obligatorio	VisAutoConnectDir	Dirección en que se dibujará la conexión. Vea la sección Comentarios para obtener los posibles valores.
Connector	Opcional	[UNKNOWN]	Conector que se va a utilizar.

Valor devuelto

Nothing

Comentarios

El método AutoConnect permite dibujar automáticamente conexiones entre las formas de la página de dibujo especificando la dirección de la conexión y, si se desea, el conector.

Para el parámetro ToShape, debe pasar el objeto Shape hasta el que desee dibujar la conexión.

Para el parámetro PlacementDir, pase un valor de la enumeración VisAutoConnectDir para especificar la dirección de la conexión; es decir, dónde buscar la forma conectada con respecto a la forma principal. Los valores posibles de PlacementDir son los siguientes.

Constante	Valor	Descripción
visAutoConnectDirDown	2	Se establece la conexión hacia abajo.
visAutoConnectDirLeft	3	Se establece la conexión hacia la izquierda.
visAutoConnectDirNone	0	Se establece la conexión sin reubicar las formas.
visAutoConnectDirRight	4	Se establece la conexión hacia la derecha.
visAutoConnectDirUp	1	Se establece la conexión hacia arriba.

Si la solución de Visual Studio incluye la referencia Microsoft.Office.Interop.Visio , este método se asigna a los tipos siguientes:

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

Ejemplo:

En la siguiente macro de Microsoft Visual Basic para Aplicaciones (VBA) se muestra cómo utilizar el método AutoConnect para dibujar una conexión entre dos formas de un diagrama de flujo, una forma de decisión y una forma de proceso, utilizando una tercera forma, un conector dinámico, todas las cuales se han agregado a una página de dibujo en blanco desde la galería de símbolos Formas para diagramas de flujo básicos (unidades de EE.UU.).

Puesto que el ejemplo llama al método desde la forma de decisión, Visio dibuja el conector desde ésta hasta la forma de proceso. Como se pasa al método el valor enumerado visAutoConnectDirRight del parámetro PlacementDir, Visio coloca automáticamente la forma de proceso a la derecha de la de decisión en la página de dibujo, sin tener en cuenta su ubicación 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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.