ReplacePageElementClipPath

コンテンツストリーム編集、クリッピングパス

説明

列挙された要素の実効クリッピング交差を構成する編集可能な 1 つのコンポーネントを確立した、正確なトップレベルパスオブジェクトを置き換えます

Function TPDFlib.ReplacePageElementClipPath(ElementID, ClipPathIndex: Integer; Const PathSource: WideString; FillRule: Integer): Integer;

ElementID	不透明なページ要素ハンドル
ClipPathIndex	`GetPageElementClipPathInfo` のプロパティ 6 が編集可能フラグを返す 1 ベースのコンポーネントインデックス
PathSource	`m` または `re` で始まる置換用パス構築命令
FillRule	`W` なら 0、`W*` なら 1

1	ソースパスが置き換えられ、すべてのページ要素ハンドルが無効化されました
0	入力が不正、キャプチャされたソースが変更済み、またはコンポーネントが読み取り専用です

キャプチャされたソースレイヤー、命令範囲、正規化フィンガープリントはすべて、書き込み前に検証されます

PathSourceの座標は元のクリッピングソース位置の現在のユーザー空間を使います。列挙されるコンポーネントジオメトリはソースCTMの後の既定ユーザー空間を使います

元の終端オペレーターがパスの描画とクリッピングの両方を行っていた場合、PDFは同じカレントパスを両方の効果に使うため、置換は描画されたジオメトリも変更します

この編集は、選択に使った要素だけでなく、同じグラフィックス状態クリッピングコンポーネントを消費する後続のすべての要素を変更します

初期ページ境界、テキスト輪郭クリップ、フォームローカルクリップ、不正なパスオブジェクト、コンテンツレイヤーにまたがって分割されたパスは読み取り専用です

失敗時、LastErrorCodeは無効な入力で532、古くなったソースで533、読み取り専用コンポーネントで534になります