Shape.UniqueID プロパティ (Visio)

アプリケーションのスコープ内の図形を一意に識別する GUID を取得、削除、または作成します。読み取り専用です。

構文

式。 UniqueID( _fUniqueID_ )

式Shape オブジェクトを返す式。

名前	必須 / オプション	データ型	説明
fUniqueID	必須	Integer	Shape オブジェクトの一意の ID を取得、削除、または作成するか指定します。使用可能な値については備考を参照してください。

文字列

Microsoft Visio は、図形 ID と一意の ID の 2 つの ID によって図形を識別します。図形 ID は、個々の図面ページ内で図形を一意に識別する数値です。ただし、個々の図面ページの範囲外では、一意ではありません。

一意の ID は GUID です。 GUID はアプリケーション内で一意です。

図形 ID と一意の ID を変換するには、Page オブジェクトの ShapeIDsToUniqueIDs および UniqueIDsToShapeIDs メソッドを使用します。

既定では、図形には一意の ID が設定されていません。 UniqueID プロパティを設定すると、一意の ID が図形に設定されます。

Shape オブジェクトに一意の ID を設定すると、同じ ID は他の図面の図形にも使用することはできません。

fUniqueID パラメーターは、UniqueID プロパティの動作を制御します。このパラメーターには、Visio タイプライブラリの VisUniqueIDArgs で宣言されている次のいずれかの値を設定します。

定数	値	説明
visGetGUID	0	図形に一意の ID が既に割り当てられている場合にのみ、一意の ID の文字列を返します。それ以外の場合は、長さ 0 の文字列 ("") を返します。
visGetOrMakeGUID	1	図形が持つ一意の ID の文字列を返します。図形に一意の ID がない場合、図形に一意の ID を割り当ててから、新しい ID を返します。
visDeleteGUID	2	図形の一意の ID を削除して、長さ 0 の文字列 ("") を返します。
visGetOrMakeGUIDWithUndo	3	図形が持つ一意の ID の文字列を返します。図形に一意の ID がまだない場合は、その ID を図形に割り当てて、新しい ID を返します。元に戻すことができます。
visDeleteGUIDWithUndo	4	図形の一意の ID をクリアし、長さ 0 の文字列 ("") を返します。元に戻すことができます。

一意の ID がわかっている場合に図形を取得するには、 Shapes.Item ( UniqueIDString) を使用します。

次のコードは使用の一例です。

Dim vsoShape As Visio.Shape 
Set vsoShape = Visio.ActivePage.Shapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")

次のコードを使用して文字列の前に文字 "U" を追加し、一意の ID として識別することもできます。

Dim vsoShape As Visio.Shape 
Set vsoShape = Visio.ActivePage.Shapes.Item("U{2287DC42-B167-11CE-88E9-0020AFDDD917}")

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