Compartilhar via


TVM_GETISEARCHSTRING mensagem

Recupera a cadeia de caracteres de pesquisa incremental para um controle de exibição de árvore. O controle de exibição de árvore usa a cadeia de caracteres de pesquisa incremental para selecionar um item com base em caracteres digitado pelo usuário. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetISearchString .

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para o buffer que recebe a cadeia de caracteres de pesquisa incremental.

Valor retornado

Retorna o número de caracteres na cadeia de caracteres de pesquisa incremental.

Comentários

Aviso de segurança: Usar essa mensagem incorretamente pode comprometer a segurança do programa. Você deve alocar um buffer grande o suficiente para manter a cadeia de caracteres. Primeiro chame a mensagem passando NULL em lParam. Isso retorna o número de caracteres, excluindo NULL, que são necessários. Em seguida, chame a mensagem uma segunda vez para recuperar a cadeia de caracteres. Você deve examinar considerações de segurança: Controles do Microsoft Windows antes de continuar.

Se o controle de exibição de árvore não estiver no modo de pesquisa incremental, o valor retornado será zero.

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
TVM_GETISEARCHSTRINGW (Unicode) e TVM_GETISEARCHSTRINGA (ANSI)