Skip to content

Latest commit

 

History

History
51 lines (29 loc) · 1.78 KB

Visio.Shapes.ItemFromUniqueID.md

File metadata and controls

51 lines (29 loc) · 1.78 KB
title keywords f1_keywords api_name ms.assetid ms.date ms.localizationpriority
Shapes.ItemFromUniqueID property (Visio)
vis_sdr.chm11362485
vis_sdr.chm11362485
Visio.Shapes.ItemFromUniqueID
94175764-d65d-9511-4073-864ff89f573c
06/08/2017
medium

Shapes.ItemFromUniqueID property (Visio)

Returns the Shape object that matches the specified UniqueID property value. Read-only.

Syntax

expression. ItemFromUniqueID( _UniqueID_ )

expression A variable that represents a Shapes object.

Parameters

Name Required/Optional Data type Description
UniqueID Required String The unique ID of a Shape object.

Return value

Shape

Remarks

Microsoft Visio identifies shapes by two different IDs: shape IDs and unique IDs. Shape IDs are numeric and uniquely identify shapes within the scope of an individual drawing page or master. They are not unique within the scope of the drawing, however.

Unique IDs are GUIDs. They are unique within the scope of the document.

To convert between shape IDs and unique IDs, you can use two methods of the Page object, ShapeIDsToUniqueIDs and UniqueIDsToShapeIDs.

By default, a shape does not have a unique ID. A shape acquires a unique ID only if you get its read-only UniqueID property value by calling the property on the shape, passing it the visGetOrMake constant from the VisUniqueIDArgs enumeration.

If a Shape object has a unique ID, no other shape in the same document will have the same ID.

[!includeSupport and feedback]