GetWindowDC 函式 (winuser.h)

GetWindowDC 函式會擷取整個視窗的DC) 裝置 (內容,包括標題列、功能表和滾動條。 視窗裝置內容允許在視窗的任何位置繪製,因為裝置內容的原點是視窗左上角,而不是工作區。

GetWindowDC 會在每次擷取裝置內容時,將預設屬性指派給視窗裝置內容。 先前的屬性會遺失。

語法

HDC GetWindowDC(
  [in] HWND hWnd
);

參數

[in] hWnd

具有要擷取之裝置內容的視窗句柄。 如果此值為 NULL,GetWindowDC 會擷取整個畫面的裝置內容。

如果此參數為 NULL,GetWindowDC 會擷取主要顯示器監視器的裝置內容。 若要取得其他顯示監視器的裝置內容,請使用 EnumDisplayMonitors 和 CreateDC 函式。

傳回值

如果函式成功,則傳回值是指定視窗之裝置內容的句柄。

如果函式失敗,傳回值為 NULL,表示錯誤或 無效的 hWnd 參數。

備註

GetWindowDC 適用於視窗非工作區內的特殊繪製效果。 不建議在任何視窗的非客戶端區域中繪製。

GetSystemMetrics 函式可用來擷取非客戶端區域的各種部分維度,例如標題欄、功能表和滾動條。

GetDC 函式可用來擷取整個畫面的裝置內容。

繪製完成之後,必須呼叫 ReleaseDC 函式以釋放裝置內容。 未釋放視窗裝置內容會對應用程式所要求的繪製有嚴重影響。

規格需求

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

另請參閱

BeginPaint

GetDC

GetSystemMetrics

繪製和繪製函式

繪製和繪圖概觀

ReleaseDC