共用方式為


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 函式使用。

[in] x

要繪製影像的水準位置,以裝置單位為單位。

[in] y

垂直位置,以裝置單位為單位,用來繪製影像。

[in] cx

影像的寬度,以裝置單位為單位。 如果映像類型DST_COMPLEX,則需要此參數。 否則,計算影像的寬度可以是零。

[in] cy

影像的高度,以裝置單位為單位。 如果映像類型DST_COMPLEX,則需要此參數。 否則,計算影像的高度可以是零。

[in] uFlags

映射類型和狀態。 此參數可以是下列其中一個類型值。

值 (類型) 意義
DST_BITMAP
影像是位圖。 lData 參數是位圖句柄。 請注意,無法將位圖選取至現有的裝置內容。
DST_COMPLEX
映像是已定義應用程式。 若要轉譯影像, DrawState 會呼叫 lpOutputFunc 參數所指定的回呼函式。
DST_ICON
影像是圖示。 lData 參數是圖示句柄。
DST_PREFIXTEXT
影像是可能包含快捷鍵助記鍵的文字。 DrawState 會將 ampersand (& 解譯為指示詞) ,將前置字元解譯為後面字元的底線。 lData 參數是字串的指標,而 wData 參數會指定長度。 如果 wData 為零,字串必須以 Null 終止。
DST_TEXT
影像是文字。 lData 參數是字串的指標,而 wData 參數會指定長度。 如果 wData 為零,字串必須以 Null 終止。
 

此參數也可以是下列其中一個狀態值。

值 (狀態) 意義
DSS_DISABLED
浮凸影像。
DSS_HIDEPREFIX
忽略文字中的 ampersand (&) 前置字元,因此後面的字母不會加上底線。 這必須與DST_PREFIXTEXT搭配使用。
DSS_MONO
使用 hbr 參數指定的筆刷繪製影像。
DSS_NORMAL
不進行任何修改即可繪製影像。
DSS_PREFIXONLY
只會在連字元 (&) 前置字元之後的字母位置繪製底線。 不會繪製字串中的文字。 這必須與DST_PREFIXTEXT搭配使用。
DSS_RIGHT
將文字靠右對齊。
DSS_UNION
擷取影像。
 

對於DSS_NORMAL以外的所有狀態,影像會在套用視覺效果之前轉換成單色。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。

備註

注意

winuser.h 標頭會將 DrawState 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

DrawStateProc

繪製和繪製函式

繪製和繪圖概觀