InsertPageElementClipPath

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

説明

ノンゼロまたは偶奇のクリッピングパスを追加します。影響するのは列挙されたテキスト、画像、パス要素のうち、正確に特定された1つだけです

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はターゲットを安全に編集できないことを意味します