共用方式為

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 會將連字元和 (&) 前置字元解譯為指示詞，以在後面加上字元底線。 lData 參數是字串的指標，而 wData 參數會指定長度。 如果 wData 為零，字串必須以 Null 結束。
DST_TEXT
 影像為文字。 lData 參數是字串的指標，而 wData 參數會指定長度。 如果 wData 為零，字串必須以 Null 結束。
 

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

值 (狀態) 意義
DSS_DISABLED
 浮凸影像。
DSS_HIDEPREFIX
 忽略文字中的連字元和 (&) 前置字元，因此後面的字母不會加底線。 這必須與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 [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

DrawStateProc

繪製和繪圖函式

繪製和繪圖概觀