CapturePageEx
Manipulare pagini
Descriere
Această funcție "capturează" o pagină. Odată ce pagina a fost capturată, ea poate fi desenată pe alte pagini. Acest lucru este util pentru combinarea unor pagini diferite sau pentru plasarea mai multor pagini originale pe o altă pagină (impunere la tipar). Odată ce o pagină a fost capturată, ea este eliminată din document. Dacă doriți ca pagina să rămână în document, trebuie să creați o pagină goală și să desenați pagina capturată pe pagina goalăDe asemenea, deoarece un document trebuie să aibă în permanență cel puțin o pagină, nu este posibilă capturarea unei pagini dacă aceasta este singura pagină din document. În acest caz, trebuie să adăugați o nouă pagină goală înainte ca pagina existentă să poată fi capturatăCapturePageEx elimină pagina capturată din documentul său curent; folosiți
Mai mult, cum un document trebuie să aibă mereu cel puțin o pagină, nu este posibil să capturezi o pagină dacă este singura pagină din document. În acest caz, trebuie să adaugi o pagină nouă goală înainte ca pagina existentă să poată fi capturată
ImportPageAsFormXObject pentru a păstra pagina sursă sau pentru a o importa din alt document deschis"Media box"-ul paginii este folosit ca dreptunghi delimitator pentru pagina capturată. Funcția CapturePageEx poate fi folosită în cazurile în care ar trebui folosit în schimb "crop box"-ul paginii
"Media box"-ul paginii este folosit ca dreptunghi limită pentru pagina capturată. Funcția CapturePageEx poate fi folosită în cazurile în care ar trebui folosit în schimb "crop box"-ul paginii.
Sintaxă
Delphi
Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;
ActiveX
Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long
DLL
int DLCapturePageEx(int InstanceID, int Page, int Options);
Parametri
| Page | Numărul paginii de capturat. Prima pagină din document este pagina 1 |
|---|---|
| Options | 0 = Folosește media box-ul paginii ca dreptunghi delimitator 1 = Folosește crop box-ul paginii ca dreptunghi delimitator, dacă există, altfel folosește media box-ul 2 = Folosește bleed box-ul paginii ca dreptunghi delimitator, dacă există, altfel folosește crop box-ul 3 = Folosește trim box-ul paginii ca dreptunghi delimitator, dacă există, altfel folosește crop box-ul 4 = Folosește art box-ul paginii ca dreptunghi delimitator, dacă există, altfel folosește crop box-ul |
Valori returnate
| 0 | Pagina specificată nu există sau este singura pagină din document |
|---|---|
| Non-zero | ID-ul procesului de captură. Acest ID trebuie furnizat funcției DrawCapturedPage |