CEdit::SetCueBanner
Define o texto que é exibido sistema autônomo a dica de texto ou dica, em uma edição controlam quando o controle está vazio.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Parâmetros
[in] lpszText
Ponteiro para uma seqüência de caracteres que contém a sinalização para exibir no controle de edição.[in] fDrawWhenFocused
If false, na faixa de sinalização não é desenhada quando o usuário clica no controle de edição e dá ao controle o foco.If true, na faixa de sinalização é desenhada, mesmo quando o controle tem foco. A faixa de sinalização desaparece quando o usuário começa a digitar no controle.
O valor padrão é false.
Valor de retorno
true Se o método for bem-sucedida; caso contrário false.
Comentários
Esse método envia o EM_SETCUEBANNER mensagem, que é descrita no Windows SDK. Para obter mais informações, consulte o Edit_SetCueBannerTextFocused macro.
Requisitos
Cabeçalho: afxwin.h
Este controle é suportado no Windows XP e posteriores.
Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.
Exemplo
O exemplo a seguir demonstra o CEdit::SetCueBanner método.
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);