WorksheetFunction.HLookup method (Excel) (Método WorksheetFunction.HLookup [Excel])

Procura um valor na linha superior de uma tabela ou numa matriz de valores e, em seguida, devolve um valor na mesma coluna de uma linha que especificar na tabela ou matriz. Utilize a função HLookup quando os valores de comparação estiverem localizados numa linha na parte superior de uma tabela de dados e quiser procurar um número especificado de linhas. Utilize a função ProCV quando os valores de comparação estiverem localizados numa coluna à esquerda dos dados que pretende localizar.

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	Variant	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	Variant	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	Variant	Row_index_num - o número da linha no table_array a partir do qual será devolvido o valor correspondente. Um row_index_num de 1 devolve o valor da primeira linha em table_array, uma row_index_num de 2 devolve o valor da segunda linha em table_array, etc. Se row_index_num for inferior a 1, o HLookup devolve o #VALUE! valor de erro; se row_index_num for maior do que o número de linhas no table_array, hLookup devolve o #REF! valor de erro.
Arg4	Opcional	Variant	Range_lookup - um valor lógico que especifica se pretende que o HLookup encontre uma correspondência exata ou uma correspondência aproximada. Se for Verdadeiro ou omitido, é devolvida uma correspondência aproximada. 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 for Falso, o HLookup irá 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 Verdadeiro, utiliza o maior valor que é inferior a lookup_value.

Se lookup_value for menor do que o menor valor na primeira linha de table_array, hLookup devolve o valor de erro #N/D.

Se range_lookup for Falso e lookup_value for texto, pode utilizar os carateres universais, o ponto de interrogação (?) e o asterisco (*), no 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.