PATHOBJ_bEnumClipLines 函数 (winddi.h)

PATHOBJ_bEnumClipLines 函数枚举给定路径中剪裁的线段。

语法

ENGAPI BOOL PATHOBJ_bEnumClipLines(
  PATHOBJ  *ppo,
  ULONG    cb,
  CLIPLINE *pcl
);

ppo

指向 PATHOBJ 结构的指针，该结构包含要枚举的剪裁线段。

cb

指定输出缓冲区的大小（以字节为单位）。 GDI 不会在缓冲区中写入超过此点。此参数的值必须足够大，才能保存具有至少一个 RUN 结构的 CLIPLINE 结构。驱动程序应为多个 RUN 结构分配空间。

pcl

指向接收 CLIPLINE 结构的缓冲区的指针。结构包含线段的原始未剪切控制点。 (如果没有原始点，则无法计算线条的正确像素。) RUN 结构（描述沿行未剪断的像素集）将写入此缓冲区。

如果剪裁区域很复杂，则可以将单个线段拆分为多个 RUN 结构。将根据需要多次返回段，以列出其所有 RUN 结构。

CLIPLINE 结构包含原始未剪切线的起始点和终点，以及要显示在显示器上的该线条的线段或 RUN 结构。

如果要枚举更多线段，则返回值为 TRUE ，表示应再次调用此服务。否则，它为 FALSE，表示返回的段是路径中的最后一个段。

在驱动程序进行此调用之前，必须使用 PATHOBJ_vEnumStartClipLines 启动枚举。


最低受支持的客户端	适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台	通用
标头	winddi.h (包括 Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys