複製鏈接
請複製以下鏈接發送給好友

GetDCEx

鎖定
GetDCEx是指檢索指定窗口客户區域或整個屏幕的顯示設備上下文環境的句柄,在隨後的GDI函數中可以使用該句柄在設備上下文環境中繪圖的一個函數。
中文名
GetDCEx
函數功能
函數檢索指定窗口客户區域
函數原型
HDC GetDCEx
基本參數
hWnd:窗口的句柄

GetDCEx函數介紹

函數原型
HDC GetDCEx(HWND hWnd, HRGN hrgnClip, DWORD flags)

GetDCEx參數介紹

GetDCEx基本參數

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函數。

GetDCEx註釋

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