Compartilhar via


LVM_GETISEARCHSTRING mensagem

Recupera a cadeia de caracteres de pesquisa incremental de um controle de exibição de lista. Você pode enviar essa mensagem explicitamente ou usando a macro ListView_GetISearchString .

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para um buffer que recebe a cadeia de caracteres de pesquisa incremental. Para recuperar apenas o comprimento da cadeia de caracteres, defina lParam como NULL.

Valor retornado

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

Comentários

Aviso de segurança: Usar essa mensagem incorretamente pode comprometer a segurança do seu programa. Essa mensagem não fornece uma maneira de saber o tamanho do buffer. Se você usar essa mensagem, primeiro chame a mensagem passando NULL no lParam, isso retornará o número de caracteres, excluindo NULL necessários. Em seguida, chame a mensagem uma segunda vez para recuperar a cadeia de caracteres. Você deve examinar as Considerações de Segurança: Controles do Microsoft Windows antes de continuar.

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 e o caractere NULL de terminação. 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]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
LVM_GETISEARCHSTRINGW (Unicode) e ansi (LVM_GETISEARCHSTRINGA )