DrawStateA 関数 (winuser.h)
DrawState 関数は、イメージを表示し、無効な状態や既定の状態などの状態を示す視覚効果を適用します。
構文
BOOL DrawStateA(
[in] HDC hdc,
[in] HBRUSH hbrFore,
[in] DRAWSTATEPROC qfnCallBack,
[in] LPARAM lData,
[in] WPARAM wData,
[in] int x,
[in] int y,
[in] int cx,
[in] int cy,
[in] UINT uFlags
);
パラメーター
[in] hdc
描画するデバイス コンテキストへのハンドル。
[in] hbrFore
fuFlags パラメーターで指定された状態がDSS_MONO場合、イメージの描画に使用されるブラシへのハンドル。 このパラメーターは、他の状態では無視されます。
[in] qfnCallBack
イメージのレンダリングに使用されるアプリケーション定義のコールバック関数へのポインター。 fuFlags のイメージの種類がDST_COMPLEX場合は、このパラメーターが必要です。 これは省略可能であり、イメージの種類がDST_TEXT場合は NULL にすることができます 。 他のすべてのイメージの種類では、このパラメーターは無視されます。 コールバック関数の詳細については、「 DrawStateProc 関数」を参照してください。
[in] lData
画像に関する情報。 このパラメーターの意味は、イメージの種類によって異なります。
[in] wData
画像に関する情報。 このパラメーターの意味は、イメージの種類によって異なります。 ただし、 DrawStateProc 関数で使用するために 0 が拡張されています。
[in] x
イメージを描画する水平方向の位置 (デバイス単位)。
[in] y
イメージを描画する垂直方向の位置 (デバイス単位)。
[in] cx
イメージの幅 (デバイス単位)。 このパラメーターは、イメージの種類がDST_COMPLEX場合に必要です。 それ以外の場合は、イメージの幅を計算するために 0 を指定できます。
[in] cy
イメージの高さ (デバイス単位)。 このパラメーターは、イメージの種類がDST_COMPLEX場合に必要です。 それ以外の場合は、イメージの高さを計算するために 0 を指定できます。
[in] uFlags
イメージの種類と状態。 このパラメーターには、次のいずれかの型値を指定できます。
このパラメーターには、次のいずれかの状態値を指定することもできます。
DSS_NORMALを除くすべての状態では、視覚効果が適用される前に画像がモノクロに変換されます。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。
注釈
注意
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DrawState を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |