Shape.UniqueID-Eigenschaft (Visio)

Artikel
04/07/2023

Ruft die GUID ab, löscht oder erstellt, die die Form innerhalb des Anwendungsbereichs eindeutig identifiziert. Schreibgeschützt.

Syntax

Ausdruck. UniqueID( _fUniqueID_ )

Ausdruck Ein Ausdruck, der ein Shape-Objekt zurückgibt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
fUniqueID	Erforderlich	Integer	Dient zum Abrufen, Löschen oder Erstellen der eindeutigen ID eines Shape-Objekts. Mögliche Werte finden Sie in den Hinweisen.

Rückgabewert

Zeichenfolge

HinwBemerkungeneise

Microsoft Visio identifiziert Shapes anhand von zwei verschiedenen IDs: Shape-IDs und eindeutigen IDs. Shape-IDs sind numerische Werte, durch die Shapes innerhalb des Bereichs eines einzelnen Zeichenblatts eindeutig identifiziert werden. In Bezug auf einen größeren Bereich sind sie jedoch nicht eindeutig.

Eindeutige IDs sind GUIDs (Globally Unique Identifier). Sie sind innerhalb des Anwendungsbereichs eindeutig.

Wenn Sie Shape-IDs in eindeutige IDs umwandeln möchten (und umgekehrt), können Sie zwei Methoden des Page-Objekts verwenden: ShapeIDsToUniqueIDs und UniqueIDsToShapeIDs.

Standardmäßig verfügt ein Shape nicht über eine eindeutige ID. Einem Shape wird nur dann eine eindeutige ID zugewiesen, wenn Sie seine UniqueID-Eigenschaft festlegen.

Wenn ein Shape-Objekt eine eindeutige ID besitzt, hat kein anderes Shape in irgendeinem Dokument dieselbe ID.

Der fUniqueID-Parameter steuert das Verhalten der UniqueID-Eigenschaft. Er sollte einen der folgenden Werte haben, die in der Visio-Typbibliothek in VisUniqueIDArgs deklariert sind.

Konstante	Wert	Beschreibung
visGetGUID	0	Gibt die eindeutige ID-Zeichenfolge nur dann zurück, wenn das Shape bereits über eine eindeutige ID verfügt. Andernfalls wird eine leere Zeichenfolge ("") zurückgegeben.
visGetOrMakeGUID	1	Gibt die eindeutige ID-Zeichenfolge des Shapes zurück. Wenn das Shape noch keine eindeutige ID besitzt, wird ihm eine zugewiesen, bevor die neue ID zurückgegeben wird.
visDeleteGUID	2	Löscht die eindeutige ID eines Shapes und gibt eine leere Zeichenfolge ("") zurück.
visGetOrMakeGUIDWithUndo	3	Gibt die eindeutige ID-Zeichenfolge des Shapes zurück. Wenn das Shape noch nicht über eine eindeutige ID verfügt, weist dem Shape eine zu und gibt die neue ID zurück. Nicht rückgängig.
visDeleteGUIDWithUndo	4	Löscht die eindeutige ID eines Shapes und gibt eine leere Zeichenfolge ("") zurück. Nicht rückgängig.

Verwenden Sie Shapes.Item ( UniqueIDString), um ein Shape abzurufen, wenn Sie die eindeutige ID kennen.

Sie können z. B. folgenden Code verwenden:

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

Sie können auch den folgenden Code verwenden, in dem der Buchstabe "U" vor der Zeichenfolge eingefügt wird, die eine eindeutige ID identifiziert:

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.