Propiedad Shape.UniqueID (Visio)
Obtiene, elimina o convierte el GUID que identifica de forma única la forma dentro del ámbito de la aplicación. Solo lectura.
Sintaxis
expresión. UniqueID( _fUniqueID_ )
Expresión Expresión que devuelve un objeto Shape .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| fUniqueID | Obligatorio | Integer | Obtiene, elimina o crea el identificador único de un objeto Shape. Vea la sección Comentarios para los valores posibles. |
Valor devuelto
Cadena
Comentarios
Microsoft Visio identifica las formas mediante dos identificadores diferentes: identificadores de formas e identificadores únicos. Los identificadores de formas son numéricos e identifican de forma única las formas dentro del ámbito de una página de dibujo individual. No obstante, no son únicos dentro de un ámbito más amplio.
Los identificadores únicos son GUID. Son únicos dentro del ámbito de la aplicación.
Para convertir entre identificadores de formas e identificadores únicos, puede usar dos métodos del objeto Page, ShapeIDsToUniqueIDs y UniqueIDsToShapeIDs.
De forma predeterminada, una forma no tiene un identificador único. Una forma adquiere un identificador único sólo si se establece su propiedad UniqueID.
Si un objeto Shape tiene un identificador único, ninguna otra forma de cualquier otro documento tendrá el mismo identificador.
El parámetro fUniqueID controla el comportamiento de la propiedad UniqueID. Debe tener uno de los siguientes valores declarados en la biblioteca de tipos de Visio en VisUniqueIDArgs.
| Constante | Valor | Descripción |
|---|---|---|
| visGetGUID | 0 | Devuelve la cadena de identificador único sólo si la forma ya tiene un identificador único. En caso contrario, devuelve una cadena de longitud cero (""). |
| visGetOrMakeGUID | 1 | Se devuelve la cadena de identificador único de la forma. Si la forma no tiene todavía un identificador único, se asigna uno a la forma y se devuelve el nuevo identificador. |
| visDeleteGUID | 2 | Elimina el identificador único de una forma y devuelve una cadena de longitud cero (""). |
| visGetOrMakeGUIDWithUndo | 3 | Se devuelve la cadena de identificador único de la forma. Si la forma aún no tiene un identificador único, asigna uno a la forma y devuelve el nuevo identificador. No se puede deshacer. |
| visDeleteGUIDWithUndo | 4 | Borra el identificador único de una forma y devuelve una cadena de longitud cero (""). No se puede deshacer. |
Para obtener una forma si conoce su identificador único, use Shapes.Item ( UniqueIDString).
Por ejemplo, puede usar el código siguiente:
Dim vsoShape As Visio.Shape
Set vsoShape = Visio.ActivePage.Shapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")
Opcionalmente, puede usar el código siguiente, que agrega la letra "U" delante de la cadena para identificarla como identificador único:
Dim vsoShape As Visio.Shape
Set vsoShape = Visio.ActivePage.Shapes.Item("U{2287DC42-B167-11CE-88E9-0020AFDDD917}")
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.