次の方法で共有

DrawStatusTextA 関数 (commctrl.h)

  • [アーティクル]

DrawStatusText 関数は、指定したテキストを罫線付きの状態ウィンドウのスタイルで描画します。

構文

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  pszText,
  UINT    uFlags
);

パラメーター

hDC

型: HDC

ウィンドウの表示コンテキストを処理します。

lprc

型: LPCRECT

テキストが描画される四角形の位置 (クライアント座標) を含む RECT 構造体へのポインター。 この関数は、指定した四角形の端のすぐ内側に罫線を描画します。

pszText

型: LPCTSTR

表示するテキストを指定する null で終わる文字列へのポインター。 文字列内のタブ文字によって、文字列が左揃え、右揃え、中央揃えのいずれであるかが決まります。

uFlags

型: UINT

テキスト描画フラグ。 このパラメーターには、次の値を組み合わせて使用できます。

価値 意味
SBT_NOBORDERS
 指定したテキストの周囲に罫線が描画されないようにします。
SBT_POPOUT
 テキストを目立たせる強調表示された罫線を描画します。
SBT_RTLREADING
 pszText 指す文字列が、親ウィンドウのテキストとは反対の方向に表示されることを示します。

戻り値

何一つ

備考

通常のウィンドウでは、テキストが左から右 (LTR) に表示されます。 Windows ミラー化 して、ヘブライ語やアラビア語などの右から左 (RTL) を読み取る言語を表示できます。 通常、pszText 文字列は、親ウィンドウのテキストと同じ方向に表示されます。 SBT_RTLREADINGが設定されている場合、pszText 文字列は、親ウィンドウのテキストとは逆方向に読み取られます。

手記

commctrl.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DrawStatusText を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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