ReplacePageElementClipPath
内容流编辑、剪裁路径
描述
替换建立枚举元素有效裁剪交集中某个可编辑组件的精确顶层路径对象
语法
Delphi
Function TPDFlib.ReplacePageElementClipPath(ElementID, ClipPathIndex: Integer; Const PathSource: WideString; FillRule: Integer): Integer;参数
| ElementID | 不透明的页面元素句柄 |
|---|---|
| ClipPathIndex | 从 1 开始的组件索引，其可编辑标志由 GetPageElementClipPathInfo 的属性 6 返回 |
| PathSource | 以 m 或 re 开头的替换路径构造指令 |
| FillRule | W 用 0，W* 用 1 |
返回值
| 1 | 源路径已被替换且所有页面元素句柄已失效 |
|---|---|
| 0 | 输入无效、捕获的源已变化或组件为只读 |
备注
被捕获的源层、指令范围和规范化指纹在写入前都会验证
PathSource 坐标使用原裁剪源处的当前用户空间；枚举的组件几何使用源 CTM 之后的默认用户空间
若原终止算子既绘制又裁剪了该路径，替换也会改变被绘制的几何，因为 PDF 对两种效果使用同一条当前路径
该编辑会更改之后每个消费同一图形状态裁剪组件的元素，而不仅是用于选中它的元素
初始页面边界、文本轮廓裁剪、Form 局部裁剪、格式错误的路径对象以及跨内容层分割的路径均为只读
失败时 LastErrorCode：无效输入为 532，过期源为 533，只读组件为 534