Compartilhar via


Edit_SetCueBannerTextFocused 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_SetCueBannerTextFocused(
   HWND    hwnd,
   LPCWSTR lpcwText,
   BOOL    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.

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

Requisitos

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

Consulte também

Conceitual

EM_SETCUEBANNER

editar controles

Edit_SetCueBannerText

de referência de