EM_SETCUEBANNER メッセージ

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

パラメーター

wParam [in]: 編集コントロールにフォーカスがある場合でも、キューバナーが表示される場合は TRUE。それ以外の場合は FALSE。 FALSE は、ユーザーがコントロールをクリックしたときにキューバナーが消える既定の動作です。
lParam [in]: テキストキューとして表示するテキストを含む Unicode 文字列へのポインター。

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

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

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

注意

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