Table of contents
TOC
Recolher sumário
Expandir sumário

Propriedade Pages.Item (Visio)Pages.Item Property (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Retorna um item de uma coleção. A propriedade Item é a propriedade padrão para todas as coleções. Somente leitura.Returns an item from a collection. The Item property is the default property for all collections. Read-only.

SintaxeSyntax

expressão . Item ( NameUIDOrIndex )expression . Item( NameUIDOrIndex )

expressão Uma variável que representa um objeto Pages .expression A variable that represents a Pages object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
NameUIDOrIndexNameUIDOrIndexObrigatórioRequiredVariantVariantContém o nome, a ID única ou o índice do objeto a recuperar.Contains the name, unique ID, or index of the object to retrieve.

Valor retornadoReturn Value

PáginaPage

ComentáriosRemarks

Ao recuperar objetos de uma coleção, você pode omitir Item da expressão porque ele é a propriedade padrão para todas as coleções. As instruções seguintes são equivalentes para o exemplo de sintaxe dado acima:When retrieving objects from a collection, you can omit Item from the expression because it is the default property for all collections. The following statements are equivalent to the syntax example given above:

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

Você pode recuperar um objeto em um Addons , documentos , Fonts , Hyperlinks , Layers , Masters , MasterShortcuts , OLEObjects , páginas , formas ou estilos coleção passando o nome do objeto como uma expressão de cadeia de caracteres em uma Variant .You can retrieve an object in an Addons , Documents , Fonts , Hyperlinks , Layers , Masters , MasterShortcuts , OLEObjects , Pages , Shapes , or Styles collection by passing the object's name as a string expression in a Variant .

Para obter mais informações sobre como passar cadeias de caracteres de ID para a propriedade Item , consulte o tópico da propriedade UniqueID nessa referência de automação.For more information about passing ID strings to the Item property, see the topic for the UniqueID property in this Automation Reference.

ObservaçãoNote

A partir do Microsoft Visio 2000, você pode usar nomes locais e universais para se referir a formas, mestres, documentos, páginas, linhas, complementos, células, hiperlinks, estilos, fontes, atalhos mestre, objetos UI e camadas do Visio. Quando um usuário nomeia uma forma, por exemplo, o usuário está especificando um nome local. A partir do Microsoft Office Visio 2003, a planilha ShapeSheet exibe apenas nomes universais em fórmulas de células e valores. (Em versões anteriores, nomes universais não eram visíveis na interface do usuário.)Beginning with Microsoft Visio 2000, you can use both local and universal names to refer to Visio shapes, masters, documents, pages, rows, add-ons, cells, hyperlinks, styles, fonts, master shortcuts, UI objects, and layers. When a user names a shape, for example, the user is specifying a local name. Beginning with Microsoft Office Visio 2003, the ShapeSheet spreadsheet displays only universal names in cell formulas and values. (In prior versions, universal names were not visible in the user interface.)

Como um desenvolvedor, você pode usar nomes universais em um programa, quando você não deseja alterar um nome de cada vez que uma solução está localizada. Use a propriedade Item para acessar um objeto da coleção Masters , páginas , formas , estilos , camadas ou MasterShortcuts usando seu nome de local. Use a propriedade ItemU para acessar um objeto de uma dessas coleções usando o nome universal do objeto.As a developer, you can use universal names in a program when you don't want to change a name each time a solution is localized. Use the Item property to access an object in the Masters , Pages , Shapes , Styles , Layers , or MasterShortcuts collection by using its local name. Use the ItemU property to access an object from one of these collections by using the object's universal name.

Se sua solução do Visual Studio inclui a referência de Microsoft.Office.Interop.Visio , essa propriedade é mapeada para os seguintes tipos:If your Visual Studio solution includes the Microsoft.Office.Interop.Visio reference, this property maps to the following types:

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

ExemploExample

Este Microsoft Visual Basic for Applications (VBA) macro mostra como usar a propriedade Item para obter um objeto Page da coleção Pages do documento ativo e todos os objetos Shape na coleção de formas objeto Page . Imprime os nomes de todas as formas na Página1 na janela Immediate.This Microsoft Visual Basic for Applications (VBA) macro shows how to use the Item property to get a Page object from the Pages collection of the active document, and all the Shape objects in the Shapes collection of the Page object. It prints the names of all shapes on Page1 in the Immediate window.

Antes de executar essa macro, verifique se o documento ativo possui formas em Page1.Before running this macro, make sure that the active document has shapes on 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
© 2018 Microsoft