ReplacePageElementClipPath

Úpravy toku obsahu, orezové cesty

Popis

Nahradí přesný path objekt nejvyšší úrovně, který vytvořil jednu upravitelnou složku účinného průniku ořezu vypočteného prvku

Syntaxe

Delphi

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

Parametry

ElementIDNeprůhledný handle prvku stránky
ClipPathIndexIndex složky číslovaný od jedničky, jejíž příznak upravitelnosti vrací vlastnost 6 GetPageElementClipPathInfo
PathSourceNáhradní instrukce konstrukce path začínající m nebo re
FillRule0 pro W nebo 1 pro W*

Návratové hodnoty

1Zdrojový path byl nahrazen a všechny handly prvků stránky byly zneplatněny
0Vstup je neplatný, zachycený zdroj se změnil nebo je složka jen pro čtení

Poznámky

Vyňatá zdrojová vrstva, rozsah instrukcí a normalizovaný otisk se všechny ověří před zapisováním

Souřadnice PathSource používají aktuální uživatelský prostor v původním zdroji ořezu; vypočtená geometrie komponenty používá výchozí uživatelský prostor po zdrojové CTM

Když původní ukončující operátor cestu jak maloval, tak ořezával, nahrazení změní i tu malovanou geometrii, protože PDF používá stejnou aktuální cestu pro oba efekty

Úprava mění každý pozdější prvek konzumující tentýž ořezový komponent grafického stavu, nejen prvek použitý k jeho vybrání

Počáteční meze stránky, ořez textových obrysů, lokální ořez Form, poškozené objekty cest a cesty rozdělené napříč obsahovými vrstvami jsou jen pro čtení

Při selhání je LastErrorCode 532 pro neplatný vstup, 533 pro zastaralý zdroj nebo 534 pro součást jen pro čtení