WorksheetFunction.Index(Object, Double, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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.

public object Index (object Arg1, double Arg2, object Arg3, object Arg4);

Public Function Index (Arg1 As Object, Arg2 As Double, Optional Arg3 As Object, Optional Arg4 As Object) As Object

Parâmetros

Arg1

Object

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

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

Object

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

Object

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.

Retornos

Object

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 referência de linha única, use ÍNDICE(ref,,núm_coluna).

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 por ÍNDICE pode ser usado como uma referência ou como um valor. Por exemplo, a fórmula de macro CÉL("largura";ÍNDICE(A1:B2;1;2)) é equivalente a CÉL("largura";B1). A função CÉL usa o valor retornado por ÍNDICE como uma referência de célula. Por outro lado, uma fórmula como 2*INDEX(A1:B2,1,2) traduz o valor de retorno de Index para o número na célula B1.