CDC::DrawState

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

イメージを表示し、禁止状態や初期状態などの状態をビジュアルな効果で表します。

メモ :
DSS_NORMAL 以外の nFlag 状態では、ビジュアル効果を表す前に、イメージはモノクロに変換されます。

BOOL DrawState(
   CPoint pt,
   CSize size,
   HBITMAP hBitmap,
   UINT nFlags,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   CBitmap* pBitmap,
   UINT nFlags,
   CBrush* pBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   HICON hIcon,
   UINT nFlags,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   HICON hIcon,
   UINT nFlags,
   CBrush* pBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   LPCTSTR lpszText,
   UINT nFlags,
   BOOL bPrefixText = TRUE,
   int nTextLen = 0,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   LPCTSTR lpszText,
   UINT nFlags,
   BOOL bPrefixText = TRUE,
   int nTextLen = 0,
   CBrush* pBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   DRAWSTATEPROC lpDrawProc,
   LPARAM lData,
   UINT nFlags,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   DRAWSTATEPROC lpDrawProc,
   LPARAM lData,
   UINT nFlags,
   CBrush* pBrush = NULL 
);

パラメータ

pt
イメージの位置。
size
イメージのサイズ。
hBitmap
ビットマップへのハンドル。
nFlags
イメージの型と状態を指定するフラグ。設定可能な nFlags の型と状態については、Windows SDK の「DrawState」を参照してください。
hBrush
ブラシへのハンドル。
pBitmap
CBitmap オブジェクトへのポインタ。
pBrush
CBrush オブジェクトへのポインタ。
hIcon
アイコンへのハンドル。
lpszText
文字列へのポインタ。
bPrefixText
アクセラレータニーモニックを持つ文字列。パラメータ lData は文字列のアドレスを指定し、パラメータ nTextLen は長さを指定します。nTextLen が 0 のときは、文字列は NULL で終わっていると見なされます。
nTextLen
lpszText で指定する文字列の長さ。nTextLen が 0 のときは、文字列は NULL で終わっていると見なされます。
lpDrawProc
イメージを描画するのに使用するコールバック関数へのポインタ。nFlags で指定したイメージの型が DST_COMPLEX のときに必要です。イメージの型が DST_TEXT のときは NULL を設定できます。それ以外のすべての種類のイメージについては、このパラメータは無視されます。コールバック関数の詳細については、Windows SDK にある「DrawStateProc」関数を参照してください。
lData
イメージの情報。このパラメータは、イメージの型に依存しています。