Partilhar via


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

Consulte também

Referência

Classe CEdit

Gráfico de hierarquia

CEdit::GetCueBanner

EM_SETCUEBANNER

Edit_SetCueBannerTextFocused

Outros recursos

CEdit membros