Estrutura LVFINDINFOW (commctrl.h)

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 tagLVFINDINFOW {
  UINT    flags;
  LPCWSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFOW, *LPFINDINFOW;

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 lParam membro da estrutura de 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 no 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 posterior. Equivalente a LVFI_PARTIAL.
LVFI_WRAP	Continua 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 ícones grandes 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 para comparar com o texto do item. Ela só será válida se LVFI_STRING ou LVFI_PARTIAL estiver definido nos sinalizadores membro.

lParam

Tipo: LPARAM

Valor a ser comparado com o lParam membro da estrutura de LVITEM de um item de exibição de lista. Ele será válido somente se LVFI_PARAM estiver definido no sinalizadores membro.

pt

Tipo: POINT

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

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 nos sinalizadores membro.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	commctrl.h