CEdit::SetCueBanner

设置显示为文本提示的文本,或者提示,在编辑控件,该控件为空时。

BOOL SetCueBanner(
     LPCWSTR lpszText
);
BOOL SetCueBanner(
     LPCWSTR lpszText, 
     BOOL fDrawWhenFocused = FALSE
);

参数

  • [in] lpszText
    对于编辑控件包含该提示显示的字符串的指针。

  • [in] fDrawWhenFocused
    如果提示,横幅不会绘制 false,当用户在编辑控件单击并赋予控件焦点。

    如果提示,横幅绘制 true,即使该控件具有焦点。提示栏消失,当用户开始输入控件。

    默认值为 false。

返回值

true,如果方法成功;否则 false。

备注

此方法发送 EM_SETCUEBANNER 信息,在 Windows SDK所述。有关更多信息,请参见 Edit_SetCueBannerTextFocused 宏。

要求

标头: afxwin.h

此控件在Windows XP和更高版本支持。

此方法的其他要求。Windows vista公共控件的生成要求所述。

示例

下面的示例说明 CEdit::SetCueBanner 方法。

    m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);

请参见

参考

CEdit选件类

层次结构图

CEdit::GetCueBanner

EM_SETCUEBANNER

Edit_SetCueBannerTextFocused