Shape.InsertObject メソッド (Visio)

ページ、マスター シェイプ、グループに、新しい埋め込みオブジェクトまたは ActiveX コントロールを追加します。

構文

expression. InsertObject( _ClassOrProgID_ , _Flags_ )

式: Shape オブジェクトを表す変数。

パラメーター

名前	必須 / オプション	データ型	説明
ClassOrProgID	必須	String	作成するオブジェクトまたはコントロールの種類を指定します。
Flags	必須	Integer	操作を制御するフラグです。

戻り値

Shape

注釈

ClassOrProgID は、作成するオブジェクトまたはコントロールの種類を表す文字列です。 文字列形式で使用される、オブジェクトやコントロールのクラス ID (GUID)、またはクラスのハンドラーとして使用される、オブジェクトやコントロールのプログラム ID を指定します。

• ClassOrProgID がクラス ID を表す文字列の場合、"{D3E34B21-9D75-101A-8C3D-00AA001A1652}" のように表示されます。

• ClassOrProgID がプログラム ID を表す文字列の場合、"paint.picture" または "forms.combobox.1" のように表示されます。

その他のアプリケーションで提供されるオブジェクトやコントロールと、クラス ID やプログラム ID の関連付けを確認するには、ベンダーが提供するマニュアルまたはレジストリを参照してください。

引数 Flags はビットマスクであり、次の値のいずれかを指定できます。

定数	値	説明
visInsertIcon	&H10	新しい図形をアイコンとして表示します。
visInsertDontShow	&H1000	新しいオブジェクトの show 動詞を実行しません。

visInsertIcon と visInsertDontShow の両方を指定すると、InsertObject メソッドは失敗します。 アイコンとして表示されるオブジェクトを挿入するには、アプリケーションでオブジェクトの show 動詞を実行できるようにする必要があります。

引数 Flags には、次の値のいずれかを指定することもできます。

定数	値
visInsertAsControl	&H2000
visInsertAsEmbed	&H4000

ClassOrProgID に指定したクラスが、挿入可能なコントロールとしてレジストリに指定されている場合にのみ、visInsertAsControl と visInsertAsEmbed の値が機能します。 visInsertAsControl と visInsertAsEmbed のどちらも指定せず、オブジェクトがコントロールまたは埋め込みオブジェクトのいずれかである場合、オブジェクトはコントロールとして挿入されます。

以前のバージョンの Visio では、同じ呼び出しに対して応答が行われる場合、埋め込みオブジェクトが挿入されていましたが、Visio 5.0 以降のバージョンでは、コントロールが挿入される場合があります。 コントロールが挿入された場合、このメソッドは図面を設計モードで開くため、図面で実行するすべてのコードは図面が実行モードに戻るまで一時停止します。

注意

ActiveX コントロールをアプリケーションに追加する場合は、十分に注意してください。 ActiveX コントロールの設計により、その使用がセキュリティ リスクをもたらす場合があります。 信頼できる発行元のコントロールのみ使用することをお勧めします。 作成したコントロールに署名します。

警告

レジストリ エディターを通じて、またはプログラムによって、任意の方法で Windows レジストリを変更すると、常にある程度のリスクが伴います。 変更が不適切な場合、オペレーティング システムの再インストールが必要になるなどの問題が起きる場合があります。 コンピューターのレジストリの修正の際には、常にあらかじめバックアップをとるようにしてください。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。