Свойство Shape.UniqueID (Visio)
Возвращает, удаляет или создает ИДЕНТИФИКАТОР GUID, который однозначно идентифицирует фигуру в области приложения. Только для чтения.
Синтаксис
выражение. UniqueID( _fUniqueID_ )
Выражение Выражение, возвращающее объект Shape .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| fUniqueID | Обязательный | Integer | Возвращает, удаляет или создает уникальный идентификатор объекта Shape . Возможные значения см. в разделе Примечания. |
Возвращаемое значение
Строка
Замечания
Microsoft Visio идентифицирует фигуры по двум разным идентификаторам: идентификаторам фигур и уникальным идентификаторам. Идентификаторы фигур являются числовыми и однозначно определяют фигуры в области отдельной страницы документа. Однако они не являются уникальными в более широкой области.
Уникальные идентификаторы — это идентификаторы GUID. Они уникальны в области приложения.
Для преобразования между идентификаторами фигур и уникальными идентификаторами можно использовать два метода объекта Page : ShapeIDsToUniqueIDs и UniqueIDsToShapeIDs.
По умолчанию фигура не имеет уникального идентификатора. Фигура получает уникальный идентификатор только в том случае, если задано ее свойство UniqueID .
Если объект Shape имеет уникальный идентификатор, ни одна другая фигура в другом документе не будет иметь такой же идентификатор.
Параметр fUniqueID управляет поведением свойства UniqueID . Он должен иметь одно из следующих значений, объявленных в библиотеке типов Visio в VisUniqueIDArgs.
| Константа | Значение | Описание |
|---|---|---|
| visGetGUID | 0 | Возвращает строку уникального идентификатора, только если фигура уже имеет уникальный идентификатор. В противном случае возвращается строка нулевой длины (""). |
| visGetOrMakeGUID | 1 | Возвращает строку уникального идентификатора фигуры. Если фигура еще не имеет уникального идентификатора, она назначает его фигуре и возвращает новый идентификатор. |
| visDeleteGUID | 2 | Удаляет уникальный идентификатор фигуры и возвращает строку нулевой длины (""). |
| visGetOrMakeGUIDWithUndo | 3 | Возвращает строку уникального идентификатора фигуры. Если фигура еще не имеет уникального идентификатора, назначает его фигуре и возвращает новый идентификатор. Невозможно. |
| visDeleteGUIDWithUndo | 4 | Очищает уникальный идентификатор фигуры и возвращает строку нулевой длины (""). Невозможно. |
Чтобы получить фигуру, если вы знаете ее уникальный идентификатор, используйте Shapes.Item ( UniqueIDString).
Например, можно использовать следующий код:
Dim vsoShape As Visio.Shape
Set vsoShape = Visio.ActivePage.Shapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")
Кроме того, можно использовать следующий код, который добавляет букву "U" перед строкой, чтобы определить ее как уникальный идентификатор:
Dim vsoShape As Visio.Shape
Set vsoShape = Visio.ActivePage.Shapes.Item("U{2287DC42-B167-11CE-88E9-0020AFDDD917}")
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.