Propriété Shape.UniqueID (Visio)
Obtient, supprime ou crée le GUID qui identifie de façon unique la forme dans l’étendue de l’application. En lecture seule.
Syntaxe
expression. UniqueID( _fUniqueID_ )
Expression Expression qui renvoie un objet Shape .
Parameters
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| fUniqueID | Requis | Integer | Renvoie, supprime ou crée l'ID unique d'un objet Shape. Les valeurs possibles, reportez-vous à la section Remarques. |
Valeur renvoyée
Chaîne
Remarques
Microsoft Visio identifie des formes par deux identificateurs différents : des identificateurs de forme et des identificateurs uniques. Les ID de forme sont des nombres qui identifient de façon unique les formes sur une page de dessin. Ils ne sont pas uniques au-delà d’une page.
Les identificateurs uniques sont des GUID. Ils sont uniques au sein de l'étendue de l'application.
Pour effectuer une conversion entre les ID de forme et les ID uniques, vous pouvez utiliser deux méthodes de l’objet Page : ShapeIDsToUniqueIDs et UniqueIDsToShapeIDs.
Par défaut, une forme ne possède pas d’D unique. Une forme n'en possède que si sa propriété UniqueID est définie.
Si un objet Shape possède un ID unique, aucune autre forme de document n'aura le même ID.
Le paramètre IDUniquef contrôle le comportement de la propriété UniqueID. Il doit disposer de l'une des valeurs suivantes déclarée dans la bibliothèque de types de Visio dans VisUniqueIDArgs.
| Constante | Valeur | Description |
|---|---|---|
| visGetGUID | 0 | Ne renvoie la chaîne d'ID unique que si la forme possède déjà un ID unique. Dans le cas contraire, elle renvoie une chaîne de longueur nulle (""). |
| visGetOrMakeGUID | 1 | Renvoie la chaîne d'ID unique de la forme. Si la forme n'a pas encore d'ID unique, elle lui en attribue un et renvoie le nouvel ID. |
| visDeleteGUID | 2 | Supprime l'ID unique d'une forme et renvoie une chaîne de longueur nulle (""). |
| visGetOrMakeGUIDWithUndo | 3 | Renvoie la chaîne d'ID unique de la forme. Si la forme n’a pas encore d’ID unique, affecte un à la forme et retourne le nouvel ID. Annulable. |
| visDeleteGUIDWithUndo | 4 | Efface l’ID unique d’une forme et retourne une chaîne de longueur nulle (« »). Annulable. |
Pour obtenir une forme si vous connaissez son ID unique, utilisez Shapes.Item ( UniqueIDString).
Vous pouvez, par exemple, utiliser le code suivant :
Dim vsoShape As Visio.Shape
Set vsoShape = Visio.ActivePage.Shapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")
Vous pouvez également utiliser le code suivant qui ajoute la lettre « U » avant la chaîne pour l'identifier comme ID unique :
Dim vsoShape As Visio.Shape
Set vsoShape = Visio.ActivePage.Shapes.Item("U{2287DC42-B167-11CE-88E9-0020AFDDD917}")
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.