Page.InsertObject 方法 (Visio)

將新的內嵌物件或 ActiveX 控制項新增至頁面、主圖形或群組。

語法

expression。 InsertObject( _ClassOrProgID_ , _Flags_ )

表達 代表 Page 對象的變數。

參數

名稱	必要/選用	資料類型	描述
ClassOrProgID	必要	字串	會識別要建立的物件或控制項之類型。
Flags	必要項目	整數	影響作業的旗標。

傳回值

圖形

註解

ClassOrProgID 是一個字串，可識別要建立的物件或控件種類。 它可以是字串形式的物件或控件的類別標識元 (GUID) ，或是類別處理程式的物件或控件的程式識別碼。

• 如果 ClassOrProgID 是一個代表類別識別碼的字串，則它會如下所示："{D3E34B21-9D75-101A-8C3D-00AA001A1652}"。

• 如果 ClassOrProgID 是一個代表程式識別碼的字串，則它會類似 "paint.picture" 或 "forms.combobox.1" 的形式。

若要判斷與其他應用程式所提供的物件和控制項有關的類別識別碼及程式識別碼，請參閱特定廠商的文件或瀏覽登錄。

Flags 引數是一個位元遮罩，可以包含下列其中一個值。

常數	值	描述
visInsertIcon	&H10	以圖示顯示新圖形。
visInsertDontShow	&H1000	不執行新物件的顯示動詞。

如果同時指定了 visInsertIcon 及 visInsertDontShow，則 InsertObject 方法會失敗。 如果您想要插入以圖示形式顯示的物件，您必須允許應用程式執行此物件的顯示動詞。

Flags 引數也可以包含下列其中一個值。

常數	值
visInsertAsControl	&H2000
visInsertAsEmbed	&H4000

只有在 ClassOrProgID 所識別的類別在登錄中識別為可以插入的控制項時，visInsertAsControl 及 visInsertAsEmbed 中的值才會有作用。 如果 visInsertAsControl 及 visInsertAsEmbed 都未指定，而且此物件可以是控制項或內嵌的物件，則應用程式會將它以控制項的形式插入。

在一些罕見的情況下，Visio 5.0 或較新版本可能會插入控制項，而較早版本的 Visio 則會藉由插入內嵌的物件來回應相同的呼叫。 如果插入了控制項，這個方法會將文件置於設計模式下，使得在此文件中執行的所有程式碼都停止，直到此文件回到執行模式為止。

注意

當您新增 ActiveX 控制項至應用程式中時，請特別小心。 ActiveX 控制項的使用設計方式可能會造成安全性的風險。 We recommend that you use controls from trusted sources only. 簽署您撰寫的任何控制件。

警告

不論是透過註冊表編輯器或以程序設計方式，以任何方式修改 Windows 登錄一律會有某種程度的風險。 不正確的修改會導致嚴重的問題，而可能需要重新安裝作業系統。 因此，較理想的做法是在每次修改電腦的登錄之前先行進行備份。

支援和意見反應

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