CEdit::SetCueBanner
Define o texto que é exibido como a indicação de texto, ou a dica, em um controle de edição quando o controle está vazia.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Parâmetros
[in] lpszText
Ponteiro para uma cadeia de caracteres que contém a indicação para exibir o controle de edição.[in] fDrawWhenFocused
Se false, a faixa de indicação não é desenhado quando o usuário clica no controle de edição e insere o foco para o controle.Se true, a faixa de indicação é desenhado mesmo quando o controle tem o foco.A faixa de indicação desaparecer quando o usuário para digitar no controle.
o valor padrão é false.
Valor de retorno
true se o método for bem-sucedida; se não false.
Comentários
Este método envia a mensagem de EM_SETCUEBANNER , que é descrita em Windows SDK.Para obter mais informações, consulte a macro de Edit_SetCueBannerTextFocused .
Requisitos
Cabeçalho: afxwin.h
Esse controle é suportado no Windows XP e posteriormente.
Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.
Exemplo
O exemplo demonstra o método de CEdit::SetCueBanner .
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);