Compartilhar via


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);

Consulte também

Referência

Classe de CEdit

Gráfico de hierarquia

CEdit::GetCueBanner

EM_SETCUEBANNER

Edit_SetCueBannerTextFocused