InsertPageElementClipPath
内容流编辑、剪裁路径
描述
添加只影响单个精确枚举的文本、图像或路径元素的非零或奇偶裁剪路径
语法
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;参数
| ElementID | 由 EnumPageElements 或 EnumeratePageElements 返回的不透明页面元素句柄 |
|---|---|
| PathSource | 仅路径构造指令，以 m 或 re 开始，不含 W、W* 和路径绘制操作符 |
| FillRule | 0 为非零环绕规则，1 为奇偶规则 |
返回值
| 1 | 局部裁剪路径已插入，所有页面元素句柄均已失效 |
|---|---|
| 0 | 句柄或路径源无效、句柄已过期，或文本状态无法安全重建 |
备注
该方法在目标周围写入配平的 q/Q 作用域，使新的交集不会泄漏到后续页面内容
PathSource 坐标使用目标处的当前用户空间；枚举的裁剪片段和边界使用活动 CTM 之后的默认用户空间
目标位于文本对象内时，方法会创建有效的包围文本对象并重放原始的不可见走字量，因此文本提取和后续定位保持不变
会把字形轮廓贡献给裁剪的文本渲染模式为只读，因为隔离它们会改变持久的裁剪语义
失败时检查 LastErrorCode：532 表示无效输入，533 表示过期内容，534 表示目标无法安全编辑