Retornando um objeto de uma coleção (Excel)

A propriedade Item retorna um único objeto da coleção a qual pertence. O exemplo a seguir define a firstBook variável como um objeto Workbook que representa a primeira pasta de trabalho na coleção Pastas de Trabalho .

Set FirstBook = Workbooks.Item(1)

A propriedade Item é a propriedade padrão para a maioria das coleções e, portanto, você pode escrever a mesma instrução de maneira mais concisa omitindo a palavra-chave Item.

Set FirstBook = Workbooks(1)

Para obter mais informações sobre uma coleção específica, consulte o tópico da Ajuda sobre essa coleção ou a propriedade Item da coleção.

Objetos nomeados

Embora você normalmente possa especificar um valor inteiro com a propriedade Item, pode ser mais conveniente retornar um objeto pelo nome. Antes de você poder usar um nome com a propriedade Item, você precisa dar nome ao objeto. Mais frequentemente, isso é feito pela definição da propriedade Name do objeto. O exemplo seguinte cria uma planilha nomeada na pasta de trabalho ativa e, em seguida, refere-se à planilha pelo nome.

ActiveWorkbook.Worksheets.Add.Name = "A New Sheet" 
With Worksheets("A New Sheet") 
 .Range("A5:A10").Formula = "=RAND()" 
End With

Valores de índice predefinidos

Algumas coleções têm valores de índice predefinidos que você pode usar para retornar objetos simples. Cada valor de índice predefinido é representando por uma constante. Por exemplo, você especifica uma constante xlBordersIndex com a propriedade Item da coleção Borders para retornar uma única borda.

O exemplo seguinte define a borda inferior das células A1:G1 de Sheet1 como uma linha dupla.

Worksheets("Sheet1").Range("A1:A1"). _ 
 Borders.Item(xlEdgeBottom).LineStyle = xlDouble

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.