StitchPagesVertically

Page manipulation

Description

Oldalak sorozatát rendezi függőlegesen egyetlen új, magas oldallá (poszter-stílusú kompozíció); minden forrásoldal elmentésre kerül egy vektoros Form XObject objektumba, és fentről lefelé rajzolódik ki, mindegyik a TargetWidth szélességre méretezve, megtartva a méretarányt, a szomszédos oldalak közé pedig egy Gap-et szúr be

Az oldalak csökkenő oldalszámsorrendben kerülnek rögzítésre, így a korábbi oldalindexek stabilak maradnak, miközben a későbbi oldalak elrejtésre kerülnek; az új oldal magasságát a rendszer automatikusan az összes skálázott forrásmagasság összegeként számítja ki, plusz a Gap szorozva a (count - 1) értékkel; minden forrásoldal felhasználásra és elrejtésre kerül

Syntax

Delphi

Function TPDFlib.StitchPagesVertically(Const PageRanges: WideString; Gap, TargetWidth: Double): Integer;

Parameters

PageRangesEgy szabványos oldaltartomány-karakterlánc (pl. "1-3,5"); az üres érték az összes oldalt jelenti
GapAz egymást követő oldalak közé beillesztett függőleges térköz, az aktuális mértékegységekben
TargetWidthAz új kimeneti oldal szélessége; minden forrásoldal erre a szélességre lesz méretezve (a méretarány megőrzésével)

Return values

0Az összefűzést (stitch) nem sikerült végrehajtani (üres tartomány, nem pozitív TargetWidth, vagy rögzítési hiba)
>= 1Az 1-alapú oldalszám of the newly created vertical-stitch page