Método de item

  • Artigo

Retorna um membro específico de um objeto Collection por posição ou por chave.

Sintaxe

objeto. Item(index)

A sintaxe do método Item tem a seguinte qualificação de objeto e parte.

Sair Descrição
objeto Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a.
índice Obrigatório. Uma expressão que especifica a posição de um membro da coleção. Se uma expressão numérica, o índice deverá ser um número de 1 para o valor da propriedade Count da coleção. Se uma expressão de cadeia de caracteres, o índice deverá corresponder ao argumento-chave especificado quando o membro referido foi adicionado à coleção.

Comentários

Se o valor fornecido como índice não corresponder a nenhum membro existente da coleção, ocorrerá um erro. O método Item é o método padrão para uma coleção. Portanto, as seguintes linhas de código são equivalentes:

Print MyCollection(1)
Print MyCollection.Item(1)

Exemplo

Este exemplo usa o método Item para recuperar uma referência a um objeto em uma coleção. Supondo que Birthdays seja um objeto Collection , o código a seguir recupera das referências da coleção aos objetos que representam o aniversário de Bill Smith e o aniversário de Adam Smith, usando as chaves "SmithBill" e "SmithAdam" como argumentos de índice .

Observe que a primeira chamada especifica explicitamente o método Item , mas a segunda não. Ambas as chamadas funcionam porque o método Item é o padrão para um objeto Collection . As referências, atribuídas a SmithBillBD e SmithAdamBD usando Set, podem ser usadas para acessar as propriedades e os métodos dos objetos especificados.

Para executar esse código, crie a coleção e preencha-a com pelo menos os dois membros referenciados.

Dim SmithBillBD As Object
Dim SmithAdamBD As Object
Dim Birthdays
Set SmithBillBD = Birthdays.Item("SmithBill")
Set SmithAdamBD = Birthdays("SmithAdam")

Confira também

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.