GetDC 函式 (winuser.h)

發行項
03/04/2024

GetDC 函式會擷取指定視窗或整個畫面之工作區的 DC (DC 內容句柄) 。您可以在後續 GDI 函式中使用傳回的句柄，在 DC 中繪製。裝置內容是不透明的數據結構，GDI 會在內部使用其值。

GetDCEx 函式是 GetDC 的延伸模組，可讓應用程式更充分掌控裁剪在工作區中的發生方式和是否發生。

語法

HDC GetDC(
  [in] HWND hWnd
);

參數

[in] hWnd

要擷取DC之視窗的句柄。如果此值為 NULL，GetDC 會擷取整個畫面的 DC。

傳回值

如果函式成功，則傳回值是指定視窗工作區之 DC 的句柄。

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

備註

GetDC 函式會根據指定視窗的類別樣式，擷取通用、類別或私人 DC。針對類別和私人 DC，GetDC 會將先前指派的屬性保留不變。不過，針對常見的 DC，GetDC 會在每次擷取DC時，將預設屬性指派給DC。例如，預設字型是 System，這是位圖字型。因此， GetDC 所傳回之通用 DC 的句柄不會告訴您在繪製視窗時所使用的字型、色彩或筆刷。若要判斷字型，請呼叫 GetTextFace。

請注意，DC 的句柄一次只能由單一線程使用。

使用一般DC繪製之後，必須呼叫 ReleaseDC 函式以釋放DC。類別和私人DC不需要釋出。 ReleaseDC 必須從稱為 GetDC 的相同線程呼叫。 DC 數目僅受限於可用的記憶體。

範例

如需範例，請參閱使用滑鼠繪製。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll