Propiedad Pages.Item (Visio)

Devuelve un elemento de una colección. La propiedad Item es la propiedad predeterminada de todas las colecciones. Solo lectura.

Sintaxis

expresión. Item (NameUIDOrIndex)

Expresión Variable que representa un objeto Pages .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
NameUIDOrIndex	Obligatorio	Variant	Contiene el nombre, el identificador único o el índice del objeto que se va a recuperar.

Valor devuelto

Page

Comentarios

Al recuperar objetos de una colección, puede omitir Item en la expresión puesto que es la propiedad predeterminada para todas las colecciones. Las instrucciones siguientes son equivalentes al ejemplo de sintaxis anterior:

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

Puede recuperar objetos de las colecciones Addons, Documents, Fonts, Hyperlinks, Layers, Masters, MasterShortcuts, OLEObjects, Pages, Shapes o Styles pasando el nombre del objeto como expresión de cadena en un valor de tipo Variant.

Para obtener más información sobre cómo pasar cadenas de identificador a la propiedad Item , vea el tema de la propiedad UniqueID en esta referencia.

Nota:

A partir de Microsoft Visio 2000, puede usar nombres locales y universales para hacer referencia a formas, patrones, documentos, páginas, filas, complementos, celdas, hipervínculos, estilos, fuentes, accesos directos maestros, objetos de interfaz de usuario y capas de Visio. Cuando un usuario asigna un nombre a una forma, por ejemplo, el usuario especifica un nombre local. A partir de Microsoft Office Visio 2003, la hoja de cálculo ShapeSheet solo muestra nombres universales en fórmulas y valores de celda. (En versiones anteriores, los nombres universales no eran visibles en la interfaz de usuario).

Como programador, puede usar nombres universales en un programa cuando no desee cambiar un nombre cada vez que localice una solución. Use la propiedad Item para tener acceso a objetos de las colecciones Masters, Pages, Shapes, Styles, Layers o MasterShortcuts mediante su nombre local. Use la propiedad ItemU para tener acceso a los objetos de una de estas colecciones mediante el nombre universal del objeto.

Si la solución de Visual Studio incluye la referencia Microsoft.Office.Interop.Visio , esta propiedad se asigna a los tipos siguientes:

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

Ejemplo:

Esta macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo usar la propiedad Item para obtener un objeto Page de la colección Pages del documento activo y todos los objetos Shape de la colección Shapes del objeto Page . Imprime los nombres de todas las formas de Page1 en la ventana Inmediato.

Antes de ejecutar esta macro, asegúrese de que el documento activo tiene formas en la página 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

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.