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

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	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 referência a partir da qual é devolvida 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, o Índice utiliza 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.

Utilize o formulário de matriz se o primeiro argumento para Índice for uma constante de matriz.

Se os argumentos row_num e column_num forem utilizados, Índice devolve o valor na célula na interseção de row_num e column_num.

Se definir row_num ou column_num como 0 (zero), Índice devolve a matriz de valores para toda a coluna ou linha, respetivamente. Para utilizar valores devolvidos como uma matriz, introduza a função Índice como uma fórmula de matriz num intervalo horizontal de células para uma linha e num intervalo vertical de células para uma coluna. Para introduzir uma fórmula de matriz, prima Ctrl+Shift+Enter.

Row_num e column_num têm de apontar para uma célula dentro da matriz; caso contrário, Índice devolve 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, utilize Í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 devolvida pelo Índice é a interseção de row_num e column_num.

Se definir row_num ou column_num como 0 (zero), Índice devolve a referência para toda a coluna ou linha, respetivamente.

Row_num, column_num e area_num têm de apontar para uma célula dentro da referência; caso contrário, Índice devolve o #REF! valor de erro. Se row_num e column_num forem omitidos, Índice devolve a área na 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 devolvido de Índice pode ser utilizado 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 utiliza o valor devolvido de Índice como referência de célula. Por outro lado, uma fórmula como 2*INDEX(A1:B2,1,2) traduz o valor devolvido de Índice 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.