在靠近指定目標圖形的頁面上建立新的圖說文字 圖形 物件,並將圖說文字與目標圖形建立關聯。 會傳回註標圖形。
語法
expression。
DropCallout( _ObjectToDrop_ , _TargetShape_ )
運算式 代表 Page 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| ObjectToDrop | 必要 | [未知] | 要新增至頁面的註標。 可以是 Master、 MasterShortcut、 Shape 或 IDataObject 物件。 |
| TargetShape | 必要 | 圖形 | 要與註標產生關聯的現有圖形。 |
傳回值
圖形
註解
如果 ObjectToDrop 參數並非 Microsoft Visio 物件,Visio 將傳回「無效的參數」錯誤。 如果傳遞的值為圖形但與此方法的內容意旨不符,Visio 則會傳回「無效的來源」錯誤。
如果 TargetShape 參數計為 null,Visio 會將註標圖形放置在頁面中央,而不會將它與任何目標圖形建立關聯。 如果指定的目標圖形並非頁面的最上層成員,Visio 將傳回「無效的參數」錯誤。
DropCallout 方法對應至 Visio 使用者介面中的 [插入圖說文字] 命令。 (在 [ 插入 ] 索引標籤上,按一下 [圖說文字]。)
範例
下列 Visual Basic for Applications (VBA) 範例示範如何使用 DropCallout 方法將圖說文字新增至使用中頁面,並將之與特定圖形建立關聯。
Dim vsoDocument As Visio.Document
Set vsoDocument = Application.Documents.OpenEx(Application.GetBuiltInStencilFile(visBuiltInStencilCallouts, visMSUS), visOpenHidden)
Application.ActivePage.DropCallout vsoDocument.Masters.ItemU("Text callout"), vsoTargetShape
vsoDocument.Close
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。