ReplacePageElementClipPath
Inhaltsstrom-Bearbeitung, Beschneidungspfade
Beschreibung
Ersetzt das exakte Pfadobjekt der obersten Ebene, das eine editierbare Komponente der effektiven Beschneidungsschnittmenge eines aufgelisteten Elements etabliert hat
Syntax
Delphi
Function TPDFlib.ReplacePageElementClipPath(ElementID, ClipPathIndex: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parameter
| ElementID | Opakes Seitenelement-Handle |
|---|---|
| ClipPathIndex | 1-basierter Komponentenindex, dessen Editierbar-Flag von Eigenschaft 6 von GetPageElementClipPathInfo zurückgegeben wird |
| PathSource | Ersatz-Pfadaufbauanweisungen beginnend mit m oder re |
| FillRule | 0 für W oder 1 für W* |
Rückgabewerte
| 1 | Der Quellpfad wurde ersetzt, und alle Seitenelement-Handles wurden ungültig |
|---|---|
| 0 | Die Eingabe ist ungültig, die erfasste Quelle hat sich geändert, oder die Komponente ist schreibgeschützt |
Hinweise
Die erfasste Quellschicht, der Anweisungsbereich und der normalisierte Fingerabdruck werden vor dem Schreiben alle validiertDie Koordinaten von
PathSource-Koordinaten verwenden den aktuellen Benutzerraum an der ursprünglichen Clip-Quelle; enumerierte Komponentengeometrie verwendet den Standardbenutzerraum nach der Quell-CTM
Wenn der ursprüngliche abschließende Operator den Pfad both malte und clippte, ändert der Ersatz auch diese gemalte Geometrie, da PDF denselben aktuellen Pfad für beide Effekte verwendet
Die Bearbeitung ändert jedes spätere Element, das dieselbe Grafikzustands-Clipkomponente nutzt, nicht nur das Element, mit dem sie ausgewählt wurde
Anfängliche Seitengrenzen, Textumriss-Clips, Form-lokale Clips, fehlerhafte Pfadobjekte und über Inhaltsebenen verteilte Pfade sind schreibgeschützt
LastErrorCode 532 für ungültige Eingabe, 533 für veraltete Quelle oder 534 für eine schreibgeschützte Komponente