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 |