InsertPageElementClipPath
Contentstreambewerking, knippaden
Beschrijving
Voegt een non-zero of even-odd knippad toe dat alleen exact één geënumereerd tekst-, afbeeldings- of padelement beïnvloedt
Syntaxis
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parameters
| ElementID | Opaak pagina-elementhandle geretourneerd door EnumPageElements of EnumeratePageElements |
|---|---|
| PathSource | Uitsluitend padconstructie-instructies, beginnend met m of re en zonder W, W* en padtekenoperators |
| FillRule | 0 voor de non-zero winding rule of 1 voor de even-odd rule |
Retourwaarden
| 1 | Het lokale knippad is ingevoegd en alle pagina-elementhandles zijn ongeldig gemaakt |
|---|---|
| 0 | De handle of padbron is ongeldig, de handle is verouderd of de teksttoestand kan niet veilig worden gereconstrueerd |
Opmerkingen
De methode schrijft een gebalanceerd q/Q-bereik rond het doel zodat de nieuwe doorsnede niet kan weglopen naar volgende pagina-inhoud
PathSource-coördinaten gebruiken de huidige gebruikersruimte op het doel; geenumereerde clippingsegmenten en begrenzingen gebruiken de standaard gebruikersruimte na de actieve CTM
Voor een doel binnen een tekstobject maakt de methode geldige omringende tekstobjecten aan en speelt de oorspronkelijke onzichtbare opschuiving af, zodat tekstextractie en latere positionering ongewijzigd blijven
Tekstrendermodi die glyphomtrekken aan clipping bijdragen zijn alleen-lezen, omdat isoleren de persistente clipsemantiek zou wijzigen
LastErrorCode: 532 betekent ongeldige invoer, 533 verouderde inhoud en 534 dat het doel niet veilig kan worden bewerkt