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

繪製和繪製函式

繪製和繪圖概觀