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