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 rajaussuorakulmiona. 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
| Page | Kaapattava sivunumero. Asiakirjan ensimmäinen sivu on sivu 1 |
|---|
Paluuarvot
| 0 | Määritettyä sivua ei ole olemassa, tai se on dokumentin ainoa sivu |
|---|---|
| Non-zero | Kaappausprosessin tunnus. Tämä tunnus on annettava DrawCapturedPage-funktiolle |