Свойство Pages.Item (Visio)

Возвращает элемент из коллекции. Свойство Item является свойством по умолчанию для всех коллекций. Только для чтения.

Синтаксис

выражение. Item (NameUIDOrIndex)

выражение Переменная, представляющая объект Pages .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
NameUIDOrIndex	Обязательный	Variant	Содержит имя, уникальный идентификатор или индекс извлекаемого объекта.

Возвращаемое значение

Страница

Примечания

При получении объектов из коллекции слово "Элемент " можно не использовать в выражении, поскольку оно является свойством по умолчанию для всех коллекций. Следующие утверждения эквивалентны приведенному выше примеру синтаксиса:

objRet = object(index)  
objRet = object(stringExpression) 

Объект можно получить в коллекции "Надстройки", "Документы", "Шрифты", "Гиперссылки", "Layers", "Masters", "MasterShortcuts","OLEObjects", "Страницы", "Фигуры" или "Стили", передав имя объекта в виде строкового выражения в Variant.

Дополнительные сведения о передаче строк идентификатора в свойство Item см. в разделе о свойстве UniqueID в этом справочнике.

Примечание.

Начиная с Microsoft Visio 2000, для обозначения фигур, образцов, документов, страниц, строк, надстроек, ячеек, гиперссылок, стилей, шрифтов, master ярлыков, объектов пользовательского интерфейса и слоев можно использовать как локальные, так и универсальные имена. Например, когда пользователь дает имя фигуре, он указывает локальное имя. Начиная с Microsoft Office Visio 2003, в формулах и значениях ячеек отображается только таблица свойств фигур. (В предыдущих версиях универсальные имена не отображались в пользовательском интерфейсе.)

Разработчик может использовать универсальные имена в программе, если вы не хотите менять имя каждый раз при локализации решения. Используйте свойство Item для доступа к объекту в коллекции Masters, Pages, Shapes, Styles, Layers или MasterShortcuts с помощью его локального имени. Используйте свойство ItemU для доступа к объекту из одной из этих коллекций с помощью универсального имени объекта.

Если решение Visual Studio содержит ссылку microsoft.Office.Interop.Visio, это свойство сопоставляется со следующими типами:

• Microsoft.Office.Interop.Visio.IVPages.this[object]

Пример

В этом макросе Microsoft Visual Basic для приложений (VBA) показано, как использовать свойство Item для получения объекта Page из коллекции Pages активного документа и всех объектов Shape в коллекции Shapes объекта Page. Она выводит имена всех фигур со страницы 1 в окне интерпретации.

Перед запуском этого макроса убедитесь, что активный документ содержит фигуры на странице Page1.

 
Public Sub Item_Example() 
  
    Dim intCounter As Integer 
    Dim intShapeCount As Integer 
    Dim vsoShapes As Visio.Shapes  
 
    Set vsoShapes = ActiveDocument.Pages.Item(1).Shapes  
 
    Debug.Print "Shape Name List For..." 
    Debug.Print "Document: "; ActiveDocument.Name  
    Debug.Print "Page: "; ActiveDocument.Pages.Item(1).Name  
 
    intShapeCount = vsoShapes.Count  
 
    If intShapeCount > 0 Then 
        For intCounter = 1 To intShapeCount  
            Debug.Print " "; vsoShapes.Item(intCounter).Name  
        Next intCounter  
    Else 
        Debug.Print " No Shapes On Page"  
    End If   
 
End Sub

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.