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 のサポートおよびフィードバックを参照してください。