CDC::DrawState

發行項
02/28/2013

呼叫此成員函式以顯示影像並套用視覺效果以指示狀態，如停用或預設狀態。

注意事項
如需 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 Type 和 State 查看 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
指定影像的相關資訊。這個參數的意義取決於影像類型。