BeginBufferedPaint 函数 (uxtheme.h)

开始缓冲绘制操作。

语法

HPAINTBUFFER BeginBufferedPaint(
        HDC             hdcTarget,
        const RECT      *prcTarget,
        BP_BUFFERFORMAT dwFormat,
  [in]  BP_PAINTPARAMS  *pPaintParams,
  [out] HDC             *phdc
);

参数

hdcTarget

类型: HDC

将绘制缓冲区的目标 DC 的句柄。

prcTarget

类型: const RECT*

指向 RECT 结构的指针,该结构指定要在其中绘制的目标 DC 的区域。

dwFormat

类型: BP_BUFFERFORMAT

指定缓冲区格式的 BP_BUFFERFORMAT 枚举的成员。

[in] pPaintParams

类型: BP_PAINTPARAMS*

指向定义绘制操作参数 的BP_PAINTPARAMS 结构的指针。 此值可以为 NULL

[out] phdc

类型: HDC*

当此函数返回时, 指向新设备上下文的句柄。

返回值

类型: HPAINTBUFFER

缓冲的绘制上下文的句柄。 如果此函数失败,则返回值为 NULLphdcNULL。 要获得更多的错误信息,请调用 GetLastError。

调用 EndBufferedPaint 时释放返回的句柄。

在调用 BeginBufferedPaint 之前,应用程序应在调用线程上调用 BufferedPaintInit,并在线程终止之前调用 BufferedPaintUnInit 调用 BufferedPaintInit 失败可能会导致性能下降,因为每个缓冲的绘制操作的内部数据都会被初始化和销毁。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 uxtheme.h
DLL UxTheme.dll