GetDCEx

該函式檢索指定視窗客戶區域或整個螢幕的顯示設備上下文環境的句柄,在隨後的GDI函式中可以使用該句柄在設備上下文環境中繪圖。

基本介紹

  • 中文名:GetDCEx
  • 函式功能:函式檢索指定視窗客戶區域
  • 函式原型:HDC GetDCEx
  • 基本參數:hWnd:視窗的句柄
函式介紹,函式功能,函式原型,參數介紹,基本參數,注釋,

函式介紹

函式功能

該函式檢索指定視窗客戶區域或整個螢幕的顯示設備上下文環境的句柄,在隨後的GDI函式中可以使用該句柄在設備上下文環境中繪圖。

函式原型

HDC GetDCEx(HWND hWnd, HRGN hrgnClip, DWORD flags)

參數介紹

基本參數

hWnd:視窗的句柄,該視窗的設備上下文環境將要被檢索,如果該值為NULL,則GetDCEx將檢索整個螢幕的設備上下文環境。
Windows98、Windows NT 5.0和以後版本:如果該參數為NULL,GetDCEx函式檢索首要顯示器的設備上下文環境,要得到其他顯示器的設備上下文環境使用EnumDisplayMonitors和CreateDC函式。
hrgnCLip:指定一剪下區域,它可以與設備上下文環境的可見區域相結合。
flags:指定如何創建設備上下文環境,可取下列值的組合:
DCX_WINDOW:返回與視窗矩形而不是與客戶矩形相對應的設備上下文環境。
DCX_CACHE:從高速快取而不是從OWNDC或CLASSDC視窗中返回設備上下文環境。從本質上覆蓋CS_OWNDC和CS_CLASSDC。
DCX_PARENTCLIP:使用父視窗的可見區域,父視窗的WS_CIPCHILDREN和CS_PARENTDC風格被忽略,並把設備上下文環境的原點,設在由hWnd所標識的視窗的左上角。
DCX_CLIPSIBLINGS:排除hWnd參數所標識視窗上的所有兄弟視窗的可見區域。
DCX_CLIPCHILDREN:排除hWnd參數所標識視窗上的所有子視窗的可見區域。
DCX_NORESETATTRS:當設備上下文環境被釋放時,並不重置該設備上下文環境的特性為預設特性。
DCX_LOCKWINDOWUPDATE:即使在排除指定視窗的LockWindowUpdate函式調用有效的情況下也許會繪製,該參數用於在跟蹤期間進行繪製。
DCX_EXCLUDERGN:從返回設備上下文環境的可見區域中排除由hrgnClip指定的剪下區域。
DCX_INTERSECTRGN:對hrgnClip指定的剪下區域與返回設備描述的可見區域作交運算。
DCX_VALIDATE:當與DCX_INTERSECTUPDATE一起指定時,致使設備上下文環境完全有效,該函式與DCX_INTERSECTUPDATE和DCX_VALIDATE一起使用時與使用BeginPaint函式相同。
返回值:如果成功,返回值是指定視窗設備上下文環境的句柄,如果失敗,返回值為Null。HWnd參數的一個無效值會使函式失敗。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。

注釋

除非顯示設備上下文環境屬於一個視窗類,在畫圖操作之後一定要調用ReleaseDC函式釋放設備上下文環境。因為只有5個公用設備上下文環境在任何給定的時間都有效。釋放設備上下文環境失敗導致其他應用程式不能訪問該設備上下文環境。
如果當視窗類註冊時,CS_CLASSDC、CS_OWNDC或CS_PARENTDC被指定為WNDCLASS結構的風格,那么該函式返回一個屬於該視窗類的設備上下文環境。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:winuser.h;庫檔案:user32.lib。

相關詞條

熱門詞條

聯絡我們