macro ListView_GetISearchString (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

void ListView_GetISearchString(
   hwndLV,
   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 como NULL.

Retornar valor

Nenhum

Comentários

A cadeia de caracteres de pesquisa incremental é a sequência de caracteres que o usuário digita enquanto o modo de exibição de lista tem o foco de entrada. Cada vez 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 a exibição.

Um período de tempo limite é associado a cada caractere que o usuário digita. Se o período de tempo limite decorrer 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

Requisito	Valor
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]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h