Estrutura LVFINDINFOA (commctrl.h)

  • Artigo

Contém informações usadas ao pesquisar um item de exibição de lista. Essa estrutura é idêntica a LV_FINDINFO mas foi renomeada para se ajustar às convenções de nomenclatura padrão.

Sintaxe

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

Membros

flags

Tipo: UINT

Tipo de pesquisa a ser executada. Esse membro pode ser definido como um ou mais dos seguintes valores:

Valor Significado
LVFI_PARAM
 Pesquisa uma correspondência entre o membro lParam dessa estrutura e o membro lParam da estrutura LVITEM de um item.
LVFI_PARTIAL
 Verifica se o texto do item começa com a cadeia de caracteres apontada pelo membro psz . Esse valor implica o uso de LVFI_STRING.
LVFI_STRING
 Pesquisa com base no texto do item. A menos que valores adicionais sejam especificados, o texto do item correspondente deve corresponder exatamente à cadeia de caracteres apontada pelo membro psz . No entanto, a pesquisa não diferencia maiúsculas de minúsculas.
LVFI_SUBSTRING
 Windows Vista e posteriores. Equivalente a LVFI_PARTIAL.
LVFI_WRAP
 Continuará a pesquisa no início se nenhuma correspondência for encontrada. Se esse sinalizador for usado por si só, supõe-se que uma pesquisa de cadeia de caracteres seja desejada.
LVFI_NEARESTXY
 Localiza o item mais próximo da posição especificada no membro pt , na direção especificada pelo membro vkDirection . Esse sinalizador tem suporte apenas por ícone grande e modos de ícone pequenos. Se LVFI_NEARESTXY for especificado, todos os outros sinalizadores serão ignorados.

psz

Tipo: LPCTSTR

Endereço de uma cadeia de caracteres terminada em nulo a ser comparada com o texto do item. Ela só será válida se LVFI_STRING ou LVFI_PARTIAL estiver definido no membro de sinalizadores .

lParam

Tipo: LPARAM

Valor a ser comparado com o membro lParam da estrutura LVITEM de um item de exibição de lista. Ela só será válida se LVFI_PARAM estiver definido no membro de sinalizadores .

pt

Tipo: POINT

Estrutura POINT com a posição de pesquisa inicial. Ela só será válida se LVFI_NEARESTXY estiver definido no membro de sinalizadores .

vkDirection

Tipo: UINT

Código de chave virtual que especifica a direção a ser pesquisada. Há suporte para os seguintes códigos:

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT
Esse membro só será válido se LVFI_NEARESTXY estiver definido no membro flags .

Comentários

Observação

O cabeçalho commctrl.h define LVFINDINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho commctrl.h