次の方法で共有


CEdit::SetCueBanner

コントロールが空の場合、と同時に編集コントロールのテキストのキュー、ツールヒント、表示されるテキストを設定します。

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

パラメーター

  • [入力] lpszText
    編集コントロールに表示するキューを含む文字列へのポインター。

  • [入力] fDrawWhenFocused
    ユーザーがエディット コントロールをクリックし、コントロールにフォーカスを設定する場合 falseが、キューの見出し描画します。

    コントロールにフォーカスがある場合でも trueが、キューの見出し描画します。キューの見出しは、ユーザーによるコントロールを入力するに表示されなくなります。

    既定値 false です。

戻り値

このメソッドが成功した場合は true。それ以外の場合は false。

解説

このメソッドは Windows SDKで説明する EM_SETCUEBANNER のメッセージを送信します。詳細については、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