通过

CWnd::GetDCEx

  • 项目

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

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

参数

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

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

    • DCX_CACHE 返回从缓存的设备上下文(而不是 OWNDC 或 CLASSDC 窗口。 重写 CS_OWNDC 和 CS_CLASSDC。

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

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

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

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

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

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

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

返回值

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

备注

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

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

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

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

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

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

要求

Header: afxwin.h

请参见

参考

CWnd 类

层次结构图

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx