CEdit::SetCueBanner
Imposta il testo da visualizzare come un'indicazione testuale, o suggerimento, in un controllo di modifica quando il controllo è vuoto.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Parametri
[in] lpszText
Puntatore a una stringa contenente indica visualizzato nel controllo di modifica.[in] fDrawWhenFocused
Se false, l'intestazione di selezione non viene tracciato quando l'utente fa clic nel controllo di modifica e non fornisce al controllo dello stato attivo.Se true, l'intestazione di selezione viene tracciato anche quando il controllo è attivo.Il messaggio per indicare scompare quando l'avvio dell'utente digita il controllo.
Il valore predefinito è false.
Valore restituito
true se il metodo ha esito positivo; in caso contrario false.
Note
Questo metodo invia il messaggio EM_SETCUEBANNER, come descritto in Windows SDK.Per ulteriori informazioni, vedere la macro Edit_SetCueBannerTextFocused.
Requisiti
intestazione: afxwin.h
Questo controllo è supportato in Windows XP e versioni successive.
i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.
Esempio
Nell'esempio seguente viene illustrato il metodo CEdit::SetCueBanner.
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);