共用方式為

DrawFrameControl 函式 (winuser.h)

  • 發行項

DrawFrameControl 函式會繪製指定類型和樣式的框架控制項。

語法

BOOL DrawFrameControl(
  [in] HDC    hdc,
  [in] LPRECT lprc,
  [in] UINT   uType,
  [in] UINT   uState
);

參數

[in] hdc

要在其中繪製控件之視窗之裝置內容的句柄。

[in] lprc

RECT 結構的指標，其中包含框架控制件周框的邏輯座標。

[in] uType

要繪製的框架控制件類型。 此參數可以是下列其中一個值。

值 意義
DFC_BUTTON
 標準按鈕
DFC_CAPTION
 標題列
DFC_MENU
 功能表列
DFC_POPUPMENU
 快捷功能表項。
DFC_SCROLL
 捲軸

[in] uState

框架控制件的初始狀態。 如果 uType 是 DFC_BUTTON，uState 可以是下列其中一個值。

值 意義
DFCS_BUTTON3STATE
 三狀態按鈕
DFCS_BUTTONCHECK
 核取方塊
DFCS_BUTTONPUSH
 按鈕
DFCS_BUTTONRADIO
 選項按鈕
DFCS_BUTTONRADIOIMAGE
 單選按鈕的影像 (非quare 需要影像)
DFCS_BUTTONRADIOMASK
 非四元 (單選按鈕的遮罩需要遮罩)
 

如果 uType 是 DFC_CAPTION，uState 可以是下列其中一個值。

值 意義
DFCS_CAPTIONCLOSE
 關閉 按鈕
DFCS_CAPTIONHELP
 說明 按鈕
DFCS_CAPTIONMAX
 最大化 按鈕
DFCS_CAPTIONMIN
 最小化 按鈕
DFCS_CAPTIONRESTORE
 還原 按鈕
 

如果 uType 是 DFC_MENU，uState 可以是下列其中一個值。

值 意義
DFCS_MENUARROW
 子功能表箭號
DFCS_MENUARROWRIGHT
 指向左的子功能表箭號。 這用於與阿拉伯文或希伯來文等右至左語言搭配使用的從右至左級聯功能表。
DFCS_MENUBULLET
 子彈
DFCS_MENUCHECK
 核取標記
 

如果 uType 是 DFC_SCROLL，uState 可以是下列其中一個值。

值 意義
DFCS_SCROLLCOMBOBOX
 下拉式方塊滾動條
DFCS_SCROLLDOWN
 滾動條向下箭號
DFCS_SCROLLLEFT
 滾動條的向左箭號
DFCS_SCROLLRIGHT
 滾動條的向右箭號
DFCS_SCROLLSIZEGRIP
 視窗右下角的大小底線
DFCS_SCROLLSIZEGRIPRIGHT
 視窗左下角的大小底框。 這與阿拉伯文或希伯來文等由右至左的語言搭配使用。
DFCS_SCROLLUP
 滾動條向上箭號
 

下列樣式可用來調整按鈕的周框。

值 意義
DFCS_ADJUSTRECT
 周框已調整，以排除按鈕的周圍邊緣。
 

下列一或多個值可用來設定要繪製之控件的狀態。

值 意義
DFCS_CHECKED
 已核取按鈕。
DFCS_FLAT
 按鈕具有平面框線。
DFCS_HOT
 按鈕是熱追蹤的。
DFCS_INACTIVE
 按鈕為非使用中 (灰色) 。
DFCS_MONO
 按鈕具有單色框線。
DFCS_PUSHED
 按鈕已按下。
DFCS_TRANSPARENT
 背景維持不變。 此旗標只能與DFCS_MENUARROWUP或DFCS_MENUARROWDOWN結合。

傳回值

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

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

備註

如果 uType 為 DFC_MENU 或 DFC_BUTTON，且 uState 未DFCS_BUTTONPUSH，則框架控件為黑色白遮罩 (，也就是白色背景的黑色框架控件) 。 在這種情況下，應用程式必須將句柄傳遞至位圖記憶體設備控制件。 然後，應用程式可以使用相關聯的點陣圖作為 MaskBlt 函式的 hbmMask 參數，也可以使用裝置內容作為 BitBlt 函式的參數，例如 SRCAND 和 SRCINVERT。

DPI 虛擬化

此 API 不會參與 DPI 虛擬化。 指定的輸入一律是以實體圖元為根據，而且與呼叫內容無關。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-draw-l1-1-2 (Windows 10 10.0.10240 版)

另請參閱

繪製和繪圖函式

繪製和繪圖概觀

矩形