Page.AutoConnectMany method (Visio)
Automatically draws multiple connections in the specified directions between the specified shapes. Returns the number of shapes connected.
Syntax
expression. AutoConnectMany
( _FromShapeIDs()_
, _ToShapeIDs()_
, _PlacementDirs()_
, _[Connector]_
)
expression A variable that represents a Page object.
Parameters
Name | Required/Optional | Data type | Description |
---|---|---|---|
FromShapeIDs() | Required | Long | An array of identifers of the shapes from which to draw a connection. |
ToShapeIDs() | Required | Long | An array of identifers of the shapes to which to draw a connection. |
PlacementDirs() | Required | Long | An array of VisAutoConnectDir constants that represent the directions in which to draw the connections. See Remarks for possible values. |
Connector | Optional | [UNKNOWN] | The connector to use. Can be a Master, MasterShortcut, Shape, or IDataObject object. |
Return value
Long
Remarks
For the PlacementDirs() parameter, pass an array of values from the VisAutoConnectDir enumeration to specify the connection directions (that is, where to locate the connected shapes with respect to the primary shapes). Possible values for PlacementDirs() are as follows.
Constant | Value | Description |
---|---|---|
visAutoConnectDirDown | 2 | Connect down. |
visAutoConnectDirLeft | 3 | Connect to the left. |
visAutoConnectDirNone | 0 | Connect without relocating the shapes. |
visAutoConnectDirRight | 4 | Connect to the right |
visAutoConnectDirUp | 1 | Connect up. |
Calling the AutoConnectMany method is equivalent to calling the Shape.AutoConnect method multiple times.
You can include the same shape multiple times in each array you pass as a parameter. You cannot use the AutoConnectMany method to connect a shape to itself.
If a particular AutoConnectMany operation fails or is invalid, Microsoft Visio skips it and processes the next item in each of the parameter arrays. AutoConnectMany returns the total number of items successfully processed.
If the parameter arrays don't each contain the same number of values, Visio returns an Invalid Parameter error.
The optional Connector parameter value must be an object that references a one-dimensional routable shape. If you don't pass a value for Connector , Visio uses the default dynamic connector.
If you use the IDataObject interface to pass a selection of shapes for Connector , Visio uses only the first shape. If Connector is not a Visio object, Visio returns an Invalid Parameter error. If Connector is not a shape that matches the context of the method, Visio returns an Invalid Source error.
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기