ReplacePageElementClipPath
內容串流編輯、剪裁路徑
描述
取代建立列舉元素有效剪裁交集中某個可編輯元件的精確頂層路徑物件
語法
Delphi
Function TPDFlib.ReplacePageElementClipPath(ElementID, ClipPathIndex: Integer; Const PathSource: WideString; FillRule: Integer): Integer;參數
| ElementID | 不透明的頁面元素控制代碼 |
|---|---|
| ClipPathIndex | 以 1 為起始的元件索引，其可編輯旗標由 GetPageElementClipPathInfo 的屬性 6 傳回 |
| PathSource | 以 m 或 re 開頭的取代用路徑建構指令 |
| FillRule | 0 表示 W，1 表示 W* |
傳回值
| 1 | 來源路徑已取代，且所有頁面元素控制代碼均已失效 |
|---|---|
| 0 | 輸入無效、擷取的來源已變更，或該元件為唯讀 |
備註
寫入前會驗證擷取的來源圖層、指令範圍與正規化指紋
PathSource 座標使用原始裁切來源當下的目前使用者空間；列舉的元件幾何使用來源 CTM 之後的預設使用者空間
若原始終止運算元同時繪製並裁切路徑，替換也會改變該繪製幾何，因為 PDF 對兩種效果使用同一條目前路徑
編輯會影響之後每個使用同一圖形狀態裁切元件的元素，不只是用來選取它的那個元素
初始頁面邊界、文字輪廓裁切、Form 本地裁切、格式錯誤的路徑物件，以及跨內容圖層分割的路徑都是唯讀
失敗時 LastErrorCode 為 532 表示輸入無效、533 表示來源已過期、534 表示元件唯讀