Compartilhar via


Edit_SetCueBannerText macro (commctrl.h)

Define o texto exibido como a indicação textual, ou dica, para um controle de edição. Você pode usar essa macro ou enviar a mensagem EM_SETCUEBANNER explicitamente.

Sintaxe

BOOL Edit_SetCueBannerText(
   HWND    hwnd,
   LPCWSTR lpcwText
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de edição.

lpcwText

Tipo: LPCWSTR

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

Valor de retorno

Tipo: BOOL

Se a macro for bem-sucedida, ela retornará VERDADEIRO. Caso contrário, ele retornará FALSE.

Observações

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 sinalização em um controle de edição de várias linhas.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h

Consulte também

Conceitual

EM_SETCUEBANNER

editar controles

Referência