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.
expressão. Item (NameUIDOrIndex)
Expressão Uma variável que representa um objeto Pages .
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. |
Page
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]
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
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.