ReplacePageElementClipPath

Edycja strumieni zawartości, ścieżki przycinania

Opis

Zastępuje dokładny obiekt ścieżki najwyższego poziomu, który utworzył jeden edytowalny składnik przecięcia przycinania efektywnego wyliczonego elementu

Składnia

Delphi

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

Parametry

ElementID	Nieprzejrzysty uchwyt elementu strony
ClipPathIndex	Indeks składnika liczony od 1, którego flaga edytowalności jest zwracana przez właściwość 6 `GetPageElementClipPathInfo`
PathSource	Instrukcje budowy ścieżki zamiennika rozpoczynające się od `m` lub `re`
FillRule	0 dla `W` albo 1 dla `W*`

Wartości zwracane

1	Ścieżka źródłowa została zastąpiona, a wszystkie uchwyty elementów strony zostały unieważnione
0	Dane wejściowe są nieprawidłowe, przechwycone źródło się zmieniło albo składnik jest tylko do odczytu

Uwagi

Przechwycona warstwa źródłowa, zakres instrukcji i znormalizowany odcisk palca są wszystkie walidowane przed zapisem

Współrzędne PathSource używają bieżącej przestrzeni użytkownika przy pierwotnym źródle przycięcia; wyenumerowana geometria komponentów używa domyślnej przestrzeni użytkownika po źródłowej CTM

Jeśli pierwotny operator kończący i malował, i przycinał ścieżkę, zamiana zmienia też tę namalowaną geometrię, bo PDF używa tej samej bieżącej ścieżki dla obu efektów

Edycja zmienia każdy późniejszy element konsumujący ten sam komponent przycięcia stanu grafiki, nie tylko element użyty do jego wybrania

Początkowe granice strony, przycięcia konturami tekstu, przycięcia lokalne dla Form, wadliwe obiekty ścieżki i ścieżki podzielone przez warstwy treści są tylko do odczytu

Po niepowodzeniu LastErrorCode przyjmuje 532 dla nieprawidłowego wejścia, 533 dla nieaktualnego źródła albo 534 dla komponentu tylko do odczytu