CWnd::GetDCEx

检索与设备上下文的处理 CWnd 窗口中。

CDC* GetDCEx( 
   CRgn* prgnClip, 
   DWORD flags  
);

参数

  • prgnClip
    确定可能将与客户端窗口的可见区域的剪辑区域。

  • flags
    可以具有以下先设置值之一:

    • DCX_CACHE 返回从缓存的设备上下文(而不是 OWNDCCLASSDC 窗口。 重写 CS_OWNDCCS_CLASSDC

    • DCX_CLIPCHILDRENCWnd windows下排除所有子窗口的可见区域。

    • DCX_CLIPSIBLINGS 排除所有同级窗口的可见区域。CWnd 窗口中。

    • DCX_EXCLUDERGN 从返回的设备上下文的可见区域排除 prgnClip 确定的剪辑区域。

    • DCX_INTERSECTRGN 相交在返回的设备上下文可见区域的 prgnClip 确定的剪辑区域。

    • DCX_LOCKWINDOWUPDATE 允许进行绘制,即使具有会排除此窗口的 LockWindowUpdate 实际调用。 此值可以为绘制使用在跟踪过程中。

    • DCX_PARENTCLIP 使用父窗口的可见区域并忽略父窗口的 WS_CLIPCHILDRENWS_PARENTDC 样式位。 此值设置为设备上下文的原点为 CWnd 窗口的左上角。

    • DCX_WINDOW 返回对应于窗口矩形而不是客户端矩形的设备上下文。

返回值

指定窗口的设备上下文,如果函数运行成功;否则 NULL

备注

设备上下文可用于对绘制的后续GDI功能在工作区。

此功能,是扩展到 GetDC 功能,如何为应用程序为,并且窗口的设备上下文是否进行更多控制剪辑。

除非设备上下文属于窗口选件类,必须调用 ReleaseDC 功能在绘制后释放上下文。 因为只有五个常见设备上下文在任何给定时间可用,未能释放设备上下文可以阻止其他应用程序获取对设备上下文。

若要获取一缓存的设备上下文,应用程序必须指定 DCX_CACHE。 如果 DCX_CACHE 未指定,并且窗口不是 CS_OWNDCCS_CLASSDC,此函数返回 NULL

有一些特征的设备上下文由 GetDCEx 函数返回,如果 CS_CLASSDCCS_OWNDCCS_PARENTDC 样式。WNDCLASS 结构指定时,选件类已注册。

有关这些属性的更多信息,请参见 WNDCLASS 结构的声明在 Windows SDK的。

要求

Header: afxwin.h

请参见

参考

CWnd 类

层次结构图

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx