Compartilhar via


EM_SETCUEBANNER mensagem

Define a indicação textual, ou dica, que é exibida pelo controle de edição para solicitar informações ao usuário.

Parâmetros

wParam [in]

TRUE se a faixa de indicação deve ser mostrada mesmo quando o controle de edição tem foco; caso contrário, FALSE. FALSE é o comportamento padrão que a faixa de indicação desaparece quando o usuário clica no controle.

lParam [in]

Um ponteiro para uma cadeia de caracteres Unicode que contém o texto a ser exibido como a indicação textual.

Valor retornado

Se a mensagem for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE.

Comentários

Um controle de edição usado para iniciar uma pesquisa pode exibir "Inserir pesquisa aqui" em texto cinza como uma indicação textual. Quando o usuário clica no texto, o texto desaparece e o usuário pode digitar.

Não é possível definir uma faixa de indicação em um controle de edição de várias linhas ou em um controle de edição avançada.

Observação

Para usar essa API, você deve fornecer um manifesto especificando Comclt32.dll versão 6.0. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

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

Confira também

Edit_SetCueBannerText