Método WorksheetFunction.Index (Excel)

Retorna um valor ou a referência para um valor de dentro de uma tabela ou intervalo. Há duas formas da função Index : o formulário de matriz e o formulário de referência.

Sintaxe

expressão. Índice (Arg1, Arg2, Arg3, Arg4)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Arg1	Obrigatório	Variantes	Matriz ou Ref - um intervalo de células ou uma constante de matriz. Para referências é a referência a um ou mais intervalos de célula.
Arg2	Obrigatório	Double	Núm_linha - seleciona a linha na matriz a partir da qual um valor deverá ser retornado. Se núm_linha for omitido, núm_coluna é obrigatório. Para referências, o número da linha em referência da qual retornar uma referência.
Arg3	Opcional	Variantes	Núm_coluna - seleciona a coluna na matriz a partir da qual um valor deverá ser retornado. Se núm_coluna for omitido, núm_linha é obrigatório. Para referências, o número da coluna em ref de onde será fornecida uma referência.
Arg4	Opcional	Variantes	Núm_área - usado apenas ao retornar referências. Seleciona um intervalo em ref do qual deve ser retornada a interseção de núm_linha com núm_coluna. A primeira área selecionada ou inserida recebe o número 1, a segunda recebe o número 2, e assim por diante. Se area_num for omitido, Index usará a área 1.

Valor de retorno

Variant

Comentários

Forma matricial

Retorna o valor de um elemento em uma tabela ou matriz selecionado pelos índices de número de linha e coluna.

Use o formulário de matriz se o primeiro argumento para Index for uma constante de matriz.

Se os argumentos row_num e column_num forem usados, Index retornará o valor na célula na interseção de row_num e column_num.

Se você definir row_num ou column_num como 0 (zero), Index retornará a matriz de valores para toda a coluna ou linha, respectivamente. Para usar valores retornados como uma matriz, insira a função Index como uma fórmula de matriz em um intervalo horizontal de células para uma linha e em um intervalo vertical de células para uma coluna. Para inserir uma fórmula de matriz, pressione Ctrl+Shift+Enter.

Row_num e column_num devem apontar para uma célula dentro da matriz; caso contrário, Index retorna o #REF! valor de erro.

Formulário de referência

Retorna a referência da célula na interseção de linha e coluna específicas. Se a referência for formada por seleções não-adjacentes, você pode escolher a seleção que deseja observar. Se cada área na referência contiver apenas uma linha ou coluna, o argumento núm_linha ou núm_coluna, respectivamente, será opcional. Por exemplo, para uma única referência de linha, use INDEX(reference,column_num).

Depois que ref e núm_área tiverem selecionado um intervalo específico, núm_linha e núm_coluna selecionam uma célula específica: núm_linha 1 é a primeira linha do intervalo, núm_coluna 1 é a primeira coluna, e assim por diante. A referência retornada pelo Index é a interseção de row_num e column_num.

Se você definir row_num ou column_num como 0 (zero), Index retornará a referência para toda a coluna ou linha, respectivamente.

Row_num, column_num e area_num devem apontar para uma célula dentro da referência; caso contrário, Index retorna o #REF! valor de erro. Se row_num e column_num forem omitidos , Index retornará a área em referência especificada por area_num.

O resultado da função Index é uma referência e é interpretado como tal por outras fórmulas. Dependendo da fórmula, o valor retornado de Index pode ser usado como referência ou como um valor. Por exemplo, a fórmula CELL("width",INDEX(A1:B2,1,2)) é equivalente a CELL("width",B1). A função CELL usa o valor retornado de Index como referência de célula. Por outro lado, uma fórmula como 2*INDEX(A1:B2,1,2) traduz o valor retornado de Index para o número na célula B1.

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.