InsertPageElementClipPath

內容串流編輯、剪裁路徑

描述

加入只影響單一精確列舉文字、影像或路徑元素的非零或偶奇剪裁路徑

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 表示目標無法安全編輯