共用方式為

DrawStateW 函式 （winuser.h）

  • 發行項

DrawState 函式會顯示影像，並套用視覺效果來指出狀態，例如停用或默認狀態。

語法

BOOL DrawStateW(
  [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
 Dithers the image.
 

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

傳回值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winuser.h （包括 Windows.h）
連結庫 User32.lib
DLL User32.dll

另請參閱

DrawStateProc

繪製和繪製函式

繪製和繪圖概觀