InsertPageElementClipPath

Inhaltsstrom-Bearbeitung, Beschneidungspfade

Beschreibung

Fügt einen nicht-null- oder even-odd-Clipping-Pfad hinzu, der nur ein exaktes aufgezähltes Text-, Bild- oder Pfadelement betrifft

Syntax

Delphi

Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;

Parameter

ElementID	Opakes Seitenelement-Handle, das von `EnumPageElements` oder `EnumeratePageElements` zurückgegeben wurde
PathSource	Nur Pfadaufbau-Anweisungen, beginnend mit `m` oder `re` und ohne `W`, `W*` und Pfadzeichen-Operatoren
FillRule	0 für die nicht-null Windungsregel oder 1 für die even-odd-Regel

Rückgabewerte

1	Der lokale Clipping-Pfad wurde eingefügt, und alle Seitenelement-Handles wurden ungültig gemacht
0	Das Handle oder die Pfadquelle ist ungültig, das Handle ist veraltet, oder der Textzustand kann nicht sicher rekonstruiert werden

Anmerkungen

Die Methode schreibt einen ausgewogenen q/Q-Scope um das Ziel, damit der neue Durchschnitt nicht in nachfolgenden Seiteninhalt hineinwirken kann

PathSource-Koordinaten verwenden den aktuellen Benutzerraum am Ziel; enumerierte Clip-Segmente und Grenzen verwenden den Standardbenutzerraum nach der aktiven CTM

Für ein Ziel innerhalb eines Textobjekts erzeugt die Methode gültige umgebende Textobjekte und spielt den ursprünglichen unsichtbaren Vorschub ab, sodass Textextraktion und spätere Positionierung unverändert bleiben

Textrenderingmodi, die Glyphenumrisse zum Clipping beitragen, sind schreibgeschützt, weil ihre Isolation die dauerhafte Clip-Semantik ändern würde

LastErrorCode: 532 bedeutet ungültige Eingabe, 533 veralteten Inhalt und 534, dass das Ziel nicht sicher bearbeitet werden kann