CreateStatusWindowA 関数 (commctrl.h)

  • [アーティクル]

通常、アプリケーションの状態を表示するために使用される状態ウィンドウを作成します。 通常、ウィンドウは親ウィンドウの下部に表示され、指定されたテキストが含まれます。

メモ この関数は廃止されました。 代わりに CreateWindow を使用してください。
 

構文

HWND CreateStatusWindowA(
  LONG   style,
  LPCSTR lpszText,
  HWND   hwndParent,
  UINT   wID
);

パラメーター

style

型: LONG

ステータス ウィンドウのウィンドウ スタイル。 このパラメーターには 、WS_CHILD スタイルを含める必要があります。 また、WS_VISIBLE スタイルも含める必要があります。

lpszText

型: LPCTSTR

最初の部分の状態テキストを指定する null で終わる文字列へのポインター。

hwndParent

種類: HWND

ハンドルを親ウィンドウに移動します。

wID

型: UINT

状態ウィンドウのコントロール識別子。 ウィンドウ プロシージャでは、この値を使用して、親ウィンドウに送信されるメッセージを識別します。

戻り値

種類: HWND

成功した場合は状態ウィンドウにハンドルを返し、それ以外の場合は NULL を 返します。 拡張エラー情報を取得するには、 GetLastError を呼び出します。

注釈

CreateStatusWindow 関数は、CreateWindow 関数を呼び出してウィンドウを作成します。 パラメーターを変更せずに に渡し、位置、幅、および高さのパラメーターを CreateWindow の既定値に設定します。

注意

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h
Library Comctl32.lib
[DLL] Comctl32.dll