Edit_SetCueBannerTextFocused マクロ (commctrl.h)

  • [アーティクル]

編集コントロールのテキスト キューまたはヒントとして表示されるテキストを設定します。 このマクロを使用することも、EM_SETCUEBANNER メッセージを明示的に送信することもできます。

構文

BOOL Edit_SetCueBannerTextFocused(
   HWND    hwnd,
   LPCWSTR lpcwText,
   BOOL    fDrawFocused
);

パラメーター

hwnd

型: HWND

エディット コントロールのハンドル。

lpcwText

型: LPCWSTR

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

fDrawFocused

型: BOOL

コントロールにキーボード フォーカスがあるときにキュー テキストを描画するかどうかを設定します。

戻り値

型: BOOL

マクロが成功した場合は、true返します。 それ以外の場合は、FALSE返します。

備考

検索を開始するために使用される編集コントロールでは、テキスト キューとして灰色のテキストに "Enter search here" と表示される場合があります。 キュー テキストが消えたときに fDrawFocused コントロールを します。 fDrawFocused が FALSE場合、編集コントロールがフォーカスを受け取るとキュー テキストが消えます。 fDrawFocused TRUE場合、ユーザーが編集コントロールにテキストを入力すると、キュー テキストが消えます。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h

関連項目

概念

EM_SETCUEBANNER

コントロールの編集

Edit_SetCueBannerText

リファレンス