CapturePageEx
Manipolazione delle pagine
Descrizione
Questa funzione "acquisisce" una pagina. Una volta acquisita, la pagina può essere disegnata su altre pagine. Ciò è utile per combinare pagine diverse o per collocare più di una pagina originale su un’altra pagina (imposizione). Dopo l’acquisizione la pagina viene rimossa dal documento. Se si vuole che la pagina resti nel documento, bisogna creare una pagina vuota e disegnare la pagina acquisita sulla pagina vuota
Poiché il documento deve avere almeno una pagina, non è possibile acquisire l'unica pagina; aggiungerne prima una vuota
CapturePageEx rimuove la pagina acquisita dal suo documento corrente; usate ImportPageAsFormXObject per preservare la pagina di origine o importarla da un altro documento aperto
La "media box" della pagina viene usata come rettangolo delimitatore della pagina acquisita. La funzione CapturePageEx può essere usata nei casi in cui debba essere usata la "crop box" della pagina al suo posto
Sintassi
Delphi
Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;ActiveX
Function PDFlib::CapturePageEx(Page As Long, Options As Long) As LongDLL
int DLCapturePageEx(int InstanceID, int Page, int Options);Parametri
| Page | Il numero della pagina da acquisire. La prima pagina del documento è la pagina 1 |
|---|---|
| Options | 0 = Usa il media box della pagina come rettangolo di delimitazione 1 = Usa il crop box della pagina come rettangolo di delimitazione se esiste, altrimenti usa il media box 2 = Usa il bleed box della pagina come rettangolo di delimitazione se esiste, altrimenti usa il crop box 3 = Usa il trim box della pagina come rettangolo di delimitazione se esiste, altrimenti usa il crop box 4 = Usa l'art box della pagina come rettangolo di delimitazione se esiste, altrimenti usa il crop box |
Valori restituiti
| 0 | La pagina specificata non esiste, oppure è l'unica pagina del documento |
|---|---|
| Non-zero | L'ID del processo di acquisizione. Questo ID deve essere fornito alla funzione DrawCapturedPage |