CapturePageEx
Χειρισμός σελίδων
Περιγραφή
Αυτή η συνάρτηση "συλλαμβάνει" μια σελίδα. Μόλις συλληφθεί η σελίδα μπορεί να σχεδιαστεί σε άλλες σελίδες. Αυτό είναι χρήσιμο για συνδυασμό διαφορετικών σελίδων ή για τοποθέτηση περισσότερων της μίας αρχικών σελίδων σε άλλη σελίδα (imposition). Μόλις συλληφθεί μια σελίδα αφαιρείται από το έγγραφο. Αν θέλετε η σελίδα να παραμείνει στο έγγραφο πρέπει να δημιουργήσετε κενή σελίδα και να σχεδιάσετε τη συλληφθείσα σελίδα πάνω στην κενή σελίδα. Επιπλέον, επειδή ένα έγγραφο πρέπει να έχει πάντα τουλάχιστον μία σελίδα, δεν είναι δυνατή η σύλληψη σελίδας αν είναι η μόνη σελίδα του εγγράφου. Σε αυτή την περίπτωση πρέπει να προσθέσετε νέα κενή σελίδα προτού μπορέσει να συλληφθεί η υπάρχουσα σελίδαΗ CapturePageEx αφαιρεί τη συλληφθείσα σελίδα από το τρέχον έγγραφό της· χρησιμοποιήστε την
Επίσης, επειδή ένα έγγραφο πρέπει να έχει τουλάχιστον μία σελίδα ανά πάσα στιγμή, δεν είναι δυνατή η καταγραφή σελίδας αν είναι η μοναδική σελίδα του εγγράφου. Στην περίπτωση αυτή πρέπει να προσθέσετε μια νέα κενή σελίδα προτού μπορεί να καταγραφεί η υπάρχουσα σελίδα.
ImportPageAsFormXObject για να διατηρήσετε τη σελίδα πηγής ή να την εισαγάγετε από άλλο ανοιχτό έγγραφο. Το "media box" της σελίδας χρησιμοποιείται ως οριοθετικό ορθογώνιο για τη συλληφθείσα σελίδα. Η συνάρτηση CapturePageEx μπορεί να χρησιμοποιηθεί σε περιπτώσεις που αντίθετα πρέπει να χρησιμοποιηθεί το "crop box" της σελίδας
Το "media box" της σελίδας χρησιμοποιείται ως ορθογώνιο οριοθέτησης για τη καταγεγραμμένη σελίδα. Η συνάρτηση CapturePageEx μπορεί να χρησιμοποιηθεί όταν πρέπει να χρησιμοποιηθεί το "crop box" της σελίδας.
Σύνταξη
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);
Παράμετροι
| Page | Ο αριθμός της σελίδας προς σύλληψη. Η πρώτη σελίδα του εγγράφου είναι η σελίδα 1 |
|---|---|
| Options | 0 = Χρήση του media box της σελίδας ως οριοθετικού ορθογωνίου 1 = Χρήση του crop box της σελίδας ως οριοθετικού ορθογωνίου αν υπάρχει, αλλιώς χρήση του media box 2 = Χρήση του bleed box της σελίδας ως οριοθετικού ορθογωνίου αν υπάρχει, αλλιώς χρήση του crop box 3 = Χρήση του trim box της σελίδας ως οριοθετικού ορθογωνίου αν υπάρχει, αλλιώς χρήση του crop box 4 = Χρήση του art box της σελίδας ως οριοθετικού ορθογωνίου αν υπάρχει, αλλιώς χρήση του crop box |
Τιμές επιστροφής
| 0 | Η καθορισμένη σελίδα δεν υπάρχει ή είναι η μόνη σελίδα του εγγράφου |
|---|---|
| Non-zero | Το ID της διαδικασίας σύλληψης. Αυτό το ID πρέπει να μεταβιβάζεται στη συνάρτηση DrawCapturedPage |