Propriedade Masters.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 Masters .

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

Master

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.

Você também pode passar a cadeia de caracteres de ID única de um objeto Master ou Shape para a propriedade Item. Por exemplo:

objRet = vsoShapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")

Se tal cadeia de caracteres passar para a propriedade Item de uma coleção Shapes, todas as formas contidas na coleção são pesquisadas. As formas dentro das formas do grupo na forma contida não são pesquisadas.

Para pesquisar todas as formas na coleção, mais as formas dentro dos grupos e a forma contida na coleção, insira antes da sequência de caracteres de ID única um asterisco (*). Por exemplo:

objRet = vsoShapes.Item("*{2287DC42-B167-11CE-88E9-0020AFDDD917}")

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.IVMasters.this[object]

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.