Método WorksheetFunction.HLookup (Excel)

Pesquisa um valor na linha superior de uma tabela ou uma matriz de valores e retorna um valor na mesma coluna de uma linha especificada na tabela ou matriz. Use o HLookup quando os valores de comparação estiverem localizados em uma linha na parte superior de uma tabela de dados e você quiser examinar um número especificado de linhas. Use o VLookup quando os valores de comparação estiverem localizados em uma coluna à esquerda dos dados que você deseja encontrar.

Sintaxe

expressão. HLookup (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	Valor_procurado - o valor a ser localizado na primeira linha da tabela. Valor_procurado pode ser um valor, uma referência ou uma sequência de caracteres de texto.
Arg2	Obrigatório	Variantes	Matriz_tabela - uma tabela de informações onde os dados devem ser procurados. Use uma referência para um intervalo ou um nome de intervalo.
Arg3	Obrigatório	Variantes	Row_index_num – o número da linha em table_array do qual o valor correspondente será retornado. Um row_index_num de 1 retorna o valor da primeira linha em table_array, um row_index_num de 2 retorna o valor da segunda linha em table_array e assim por diante. Se row_index_num for menor que 1, o HLookup retornará o #VALUE! valor de erro; se row_index_num for maior que o número de linhas em table_array, o HLookup retornará o #REF! valor de erro.
Arg4	Opcional	Variantes	Range_lookup – um valor lógico que especifica se você deseja que o HLookup encontre uma correspondência exata ou uma correspondência aproximada. Se True ou omitido, uma correspondência aproximada será retornada. Em outras palavras, se uma correspondência exata não for localizada, o valor maior mais próximo que seja menor que o valor_procurado é retornado. Se False, o HLookup encontrará uma correspondência exata. Se nenhuma correspondência for localizada, o valor de erro #N/D será retornado.

Valor de retorno

Variant

Comentários

Se o HLookup não conseguir encontrar lookup_value e range_lookup for True, ele usará o maior valor menor que lookup_value.

Se lookup_value for menor que o menor valor da primeira linha de table_array, o HLookup retornará o valor de erro #N/A.

Se range_lookup for False e lookup_value for texto, você poderá usar os caracteres curinga, o ponto de interrogação (?) e o asterisco (*), em lookup_value. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você quiser localizar um ponto de interrogação ou um asterisco, digite um til (~) antes do caractere.

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.