InsertPageElementClipPath

Edycja strumieni zawartości, ścieżki przycinania

Opis

Dodaje ścieżkę przycinania niezerową albo parzystą-nieparzystą, która wpływa tylko na jeden dokładny wyliczony element tekstu, obrazu lub ścieżki

Składnia

Delphi

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

Parametry

ElementID	Nieprzezroczysty uchwyt elementu strony zwrócony przez `EnumPageElements` lub `EnumeratePageElements`
PathSource	Wyłącznie instrukcje budowania ścieżki, zaczynające się od `m` lub `re`, bez `W`, `W*` i operatorów malowania ścieżek
FillRule	0 dla reguły niezerowej zawijasy albo 1 dla reguły parzystej-nieparzystej

Wartości zwracane

1	Lokalna ścieżka przycinania została wstawiona, a wszystkie uchwyty elementów strony unieważnione
0	Uchwyt lub źródło ścieżki jest nieprawidłowe, uchwyt jest nieaktualny albo stanu tekstu nie da się bezpiecznie odtworzyć

Uwagi

Metoda zapisuje zbalansowany zakres q/Q wokół celu, więc nowe przecięcie nie może wyciec do kolejnej treści strony

Współrzędne PathSource używają bieżącej przestrzeni użytkownika przy celu; wyenumerowane segmenty przycięcia i granice używają domyślnej przestrzeni użytkownika po aktywnej CTM

Dla celu wewnątrz obiektu tekstowego metoda tworzy ważne otaczające obiekty tekstowe i odtwarza pierwotne niewidzialne posuwanie, więc ekstrakcja tekstu i późniejsze pozycjonowanie pozostają bez zmian

Tryby renderowania tekstu wnoszące kontury glifów do przycięcia są tylko do odczytu, bo ich izolacja zmieniłaby trwałą semantykę przycinania

Po niepowodzeniu obejrzyj LastErrorCode: 532 oznacza nieprawidłowe wejście, 533 nieaktualną treść, a 534, że celu nie da się bezpiecznie edytować