macro Edit_SetCueBannerTextFocused (commctrl.h)

Artigo
02/24/2024

Define o texto que é 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

void Edit_SetCueBannerTextFocused(
   hwnd,
   lpcwText,
   fDrawFocused
);

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.

fDrawFocused

Tipo: BOOL

Define se o texto da indicação é desenhado quando o controle tem o foco do teclado.

Retornar valor

Nenhum

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. fDrawFocused controla quando o texto de indicação desaparece. Se fDrawFocused for FALSE, o texto de indicação desaparecerá quando o controle de edição receber o foco. Se fDrawFocused for TRUE, o texto de indicação desaparecerá quando o usuário inserir texto no controle de edição.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h