ListView_GetISearchString macro (commctrl.h)

Obtém a cadeia de caracteres de pesquisa incremental de um controle de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_GETISEARCHSTRING explicitamente.

Sintaxe

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

Parâmetros

hwndLV

Tipo: HWND

Um identificador para o controle de exibição de lista.

lpsz

Tipo: LPSTR

Um ponteiro para um buffer que recebe a cadeia de caracteres de pesquisa incremental. Para recuperar apenas o comprimento da cadeia de caracteres, defina lpsz para NULL.

Valor de retorno

Tipo: BOOL

Retorna o número de caracteres na cadeia de caracteres de pesquisa incremental ou zero se o controle de exibição de lista não estiver no modo de pesquisa incremental.

Observações

A cadeia de caracteres de pesquisa incremental é a sequência de caracteres que o usuário digita enquanto a exibição de lista tem o foco de entrada. Sempre que o usuário digita um caractere, o sistema acrescenta o caractere à cadeia de caracteres de pesquisa e, em seguida, pesquisa um item correspondente. Se o sistema encontrar uma correspondência, ele selecionará o item e, se necessário, o rolará para exibição.

Um período de tempo limite é associado a cada caractere que o usuário digita. Se o período de tempo limite se esgotar antes que o usuário digite outro caractere, a cadeia de caracteres de pesquisa incremental será redefinida.

Verifique se o buffer é grande o suficiente para manter a cadeia de caracteres. Se for muito pequeno, uma falha de página inválida imediata resultará.

Requisitos