メッセージのEM_SETCUEBANNER

ユーザーに情報を求めるために編集コントロールによって表示されるテキストキュー (ヒント) を設定します。

パラメーター

wParam [in]

編集コントロールにフォーカスがある場合でも、キュー バナーが表示される場合は TRUE。それ以外の場合は FALSEFALSE は、ユーザーがコントロールをクリックしたときにキュー バナーが消える既定の動作です。

lParam [in]

テキストキューとして表示するテキストを含む Unicode 文字列へのポインター。

戻り値

メッセージが成功すると、 TRUE が返されます。 それ以外の場合は FALSE が返されます。

解説

検索を開始するために使用される編集コントロールは、テキストキューとして灰色のテキストで 「ここに検索を入力」と表示される場合があります。 ユーザーがテキストをクリックすると、テキストは消え、ユーザーは入力できます。

複数行の編集コントロールまたはリッチ エディット コントロールにキュー バナーを設定することはできません。

Note

この API を使用するには、バージョン 6.0 Comclt32.dll指定するマニフェストを指定する必要があります。 マニフェストの詳細については、「 Visual スタイルの有効化」を参照してください。

必要条件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Commctrl.h

関連項目

Edit_SetCueBannerText