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 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h
Library Comctl32.lib
[DLL] Comctl32.dll