Page.DropConnected 方法 (Visio)

在頁面上建立新的 Shape 物件、放置與指定之現有靶心圖表形相對的新圖形，以及將連接器從現有圖形加入至新圖形。 會傳回新建立的圖形。

語法

運算式。 DropConnected( _ObjectToDrop_ , _TargetShape_ , _PlacementDir_ , _[Connector]_ )

表達 代表 Page 物件的變數。

參數

名稱	必要/選用	資料類型	描述
ObjectToDrop	必要	[UNKNOWN]	要新增至頁面的圖形。 可以是 Master、 MasterShortcut、 Shape或 IDataObject 物件。
TargetShape	必要	圖形	要與之對齊、保持間距及連接的現有圖形。
PlacementDir	必要	VisAutoConnectDir	ObjectToDrop 放置處相對於 TargetShape 的方向。
Connector	選用	[UNKNOWN]	要使用的連接器。 可以是 Master、MasterShortcut、Shape 或 IDataObject 物件。

傳回值

圖形

註解

ObjectToDrop參數必須是參考二維 (2D) 圖形的物件。 如果傳遞了代表圖形選取範圍的 IDataObject 物件，則 Visio 只會使用其中的第一個圖形。 如果 ObjectToDrop 不是有效的 Visio 物件，Visio 將傳回「無效的參數」錯誤。 如果 ObjectToDrop 圖形與此方法的內容意旨不符，Visio 便會傳回「無效的來源」錯誤。

TargetShape參數必須是頁面上的 2D 最上層圖形。 如果 TargetShape 無效，Visio 將傳回「無效的來源」錯誤。

PlacementDir 參數值必須是 VisAutoConnectDir 常數的其中一項。 如果您將 visAutoConnectDirNone 傳遞給 PlacementDir ，Visio 會將圖形放在預設位置 (0，0) ，然後連接它;圖形不會放在與目標的關聯中。

連接器參數必須是參考一維 (1D) 可路由圖形的物件。 如果傳遞了代表圖形選取範圍的 IDataObject 物件，則 Visio 只會使用其中的第一個圖形。 如果 Connector 不是有效的 Visio 物件，Visio 將傳回「無效的參數」錯誤。 如果 Connector 圖形與此方法的內容意旨不符，Visio 便會傳回「無效的來源」錯誤。

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。