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.