GetWindowDC 函式 (winuser.h)

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

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

語法

HDC GetWindowDC(
  [in] HWND hWnd
);

參數

[in] hWnd

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

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

傳回值

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

如果函式失敗,傳回值為 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