Visio) (Pages.Item 属性

从集合中返回一个项目。 Item 属性是所有集合的默认属性。 此为只读属性。

语法

表达式。Item (NameUIDOrIndex)

表达 一个代表 Pages 对象的变量。

参数

名称	必需/可选	数据类型	说明
NameUIDOrIndex	必需	Variant	包含要检索的对象的名称、唯一 ID 或索引。

返回值

Page

备注

从集合中检索对象时，您可以省略表达式中的 Item，因为它是所有集合的默认属性。 下列语句等效于上面给出的语法示例：

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

通过将对象名称作为 Variant 类型的字符串表达式来传递，您可以在 Addons、Documents、Fonts、Hyperlinks、Layers、Masters、MasterShortcuts、OLEObjects、Pages、Shapes 或 Styles 集合中检索对象。

有关将 ID 字符串传递给 Item 属性的详细信息，请参阅此参考中的 UniqueID 属性的主题。

注意

从 Microsoft Visio 2000 开始，您可以使用本地名称和通用名称来引用 Visio 形状、主控形状、文档、页面、行、加载项、单元格、超链接、样式、字体、主控形状快捷方式、UI 对象和图层。 例如，当用户命名形状时，用户将指定一个本地名称。 从 Microsoft Office Visio 2003 开始，ShapeSheet 电子表格在单元格公式和值中只显示通用名称。 （在以前的版本中，通用名称在用户界面中不可见。

） 作为开发人员，如果您不希望每次本地化解决方案时都更改名称，可以在程序中使用通用名称。 通过使用对象的本地名称，您可以使用 Item 属性来访问 Masters、Pages、Shapes、Styles、Layers 或 MasterShortcuts 集合中的对象。 通过使用对象的通用名称，您可以使用 ItemU 属性来访问上述任一集合中的该对象。

如果 Visual Studio 解决方案包含 Microsoft.Office.Interop.Visio 引用，则此属性映射到以下类型：

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

示例

此 Microsoft Visual Basic for Applications (VBA) 宏显示如何使用 Item 属性从活动文档的 Pages 集合获取 Page 对象，以及 Page 对象的 Shapes 集合中的所有 Shape 对象。 该宏在“立即”窗口中打印第一页上所有形状的名称。

运行此宏前，请确保活动文档在第一页上包含形状。

 
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 支持和反馈，获取有关如何接收支持和提供反馈的指南。