CEdit::SetCueBanner
Establece el texto que se mostrará como la señal de texto, o sugerencias, en un control de edición cuando el control está vacío.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Parámetros
[in] lpszText
puntero a una cadena que contiene la señal para mostrar en el control de edición.[in] fDrawWhenFocused
Si false, la pancarta señalado no se dibuja cuando el usuario hace clic en el control de edición y proporciona al control el foco.Si se dibuja true, la pancarta señalado incluso cuando el control tiene el foco.La pancarta señalado desaparece cuando el usuario empieza a escribir en el control.
El valor predeterminado es false.
Valor devuelto
true si el método es correcto; si no false.
Comentarios
este método envía el mensaje de EM_SETCUEBANNER , que se describe en Windows SDK.Para obtener más información, vea la macro de Edit_SetCueBannerTextFocused.
Requisitos
encabezado: afxwin.h
Este control se admite en Windows XP y posterior.
los requisitos adicionales para este método se describen en Requisitos de la compilación para Controles comunes de Windows Vista.
Ejemplo
En el siguiente ejemplo se muestra el método CEdit::SetCueBanner.
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);