Método WorksheetFunction.Index (Excel)

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

Sintaxe

mais simples. Í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 Variant 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 ref de onde será fornecida uma referência.
Arg3 Opcional Variant 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 Variant 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, Índice 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 a forma de matriz se o primeiro argumento de Índice for uma constante de matriz.

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

Se você definir row_num ou column_num como 0 (zero), Índice retornará a matriz de valores para toda a coluna ou linha, respectivamente. Para usar valores retornados como uma matriz, insira a função Índice 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, Índice retornará 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 referência de linha única, use ÍNDICE(referência,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 por Index é a interseção de row_num e column_num.

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

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

O resultado da função Índice é uma referência e é interpretado como tal por outras fórmulas. Dependendo da fórmula, o valor retornado por Index pode ser usado como uma 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 CÉL usa o valor retornado de Índice como uma referência de célula. Por outro lado, uma fórmula como 2*INDEX(A1:B2,1,2) converte o valor retornado de Índice no número da 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.