Ler em inglês

Compartilhar via


Propriedade Pages.Item (Visio)

Retorna um item de uma coleção. A propriedade Item é a propriedade padrão para todas as coleções. Somente leitura.

Sintaxe

expressão. Item (NameUIDOrIndex)

Expressão Uma variável que representa um objeto Pages .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
NameUIDOrIndex Obrigatório Variantes Contém o nome, a ID única ou o índice do objeto a recuperar.

Valor de retorno

Page

Comentários

Ao recuperar objetos de uma coleção, você poderá omitir Item da expressão porque ela é a propriedade padrão para todas as coleções. As seguintes instruções são equivalentes ao exemplo de sintaxe dado acima:

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

Você pode recuperar um objeto em uma coleção Addons, Documents, Fonts, Hyperlinks, Layers, Masters, MasterShortcuts, OLEObjects, Pages, Shapes ou Styles passando o nome do objeto como uma expressão de cadeia de caracteres em uma 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 nesta referência.

Observação

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, os nomes universais não eram visíveis na interface do usuário.).

Como desenvolvedor, você poderá usar nomes universais em um programa quando não quiser alterar um nome a cada vez que uma solução for localizada. Use a propriedade Item para acessar um objeto na coleção Masters, Pages, Shapes, Styles, Layers ou MasterShortcuts usando seu nome local. Use a propriedade ItemU para acessar um objeto de uma dessas coleções usando o nome universal do objeto.

Se sua solução do Visual Studio incluir a referência Microsoft.Office.Interop.Visio , essa propriedade será mapeada para os seguintes tipos:

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

Exemplo

Esta macro do Microsoft Visual Basic for Applications (VBA) 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 Shapes do objeto Page. Ela imprime os nomes de todas as formas em Page1 na janela Immediate.

Antes de executar essa macro, verifique se o documento ativo possui formas em 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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.