CDC::DrawState

發行項
06/10/2015

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

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