CapturePage

Sivujen käsittely

Kuvaus

Tämä funktio "kaappaa" sivun. Kun sivu on kaapattu, sen voi piirtää muille sivuille. Tästä on hyötyä erilaisten sivujen yhdistämisessä tai useamman alkuperäisen sivun sijoittamiselle toiselle sivulle (imposointi). Kun sivu on kaapattu, se poistetaan asiakirjasta. Jos haluat, että sivu pysyy asiakirjassa, sinun on luotava tyhjä sivu ja piirrettävä kaapattu sivu tyhjälle sivulle

Lisäksi koska asiakirjalla on aina oltava vähintään yksi sivu, sivua ei voi kaapata, jos se on asiakirjan ainoa sivu. Tällöin sinun on lisättävä uusi tyhjä sivu ennen kuin olemassa olevan sivun voi kaapata

CapturePagea ei voi käyttää sivujen siirtämiseen asiakirjasta uuteen asiakirjaan, joten kaikki tarvittavat sivut on yhdistettävä yhteen asiakirjaan ennen CapturePage-kutsua. CaptureID on vain osoitin piilotettuun sivuun, joten muistia ei tarvitse vapauttaa

Sivun "media box" käytetään kaapatun sivun rajaus­suorakulmiona. CapturePage-funktiota voi käyttää silloin, kun sivun "crop box" pitäisi käyttää sijasta

Syntaksi

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Parametrit

PageKaapattava sivunumero. Asiakirjan ensimmäinen sivu on sivu 1

Paluuarvot

0Määritettyä sivua ei ole olemassa, tai se on dokumentin ainoa sivu
Non-zeroKaappausprosessin tunnus. Tämä tunnus on annettava DrawCapturedPage-funktiolle