DASetPageBox

Λειτουργίες άμεσης πρόσβασης, ιδιότητες σελίδας

Περιγραφή

Ορίζει τις διαστάσεις των οριακών ορθογωνίων της καθορισμένης σελίδας. Το MediaBox αναπαριστά το φυσικό μέσο της σελίδας

Το CropBox αντιπροσωπεύει την ορατή περιοχή της σελίδας και το περιεχόμενο περικόπτεται σε αυτή την περιοχή. Το BleedBox είναι παρόμοιο με το CropBox, αλλά είναι το ορθογώνιο που χρησιμοποιείται σε περιβάλλον παραγωγής

Το TrimBox δηλώνει τις προβλεπόμενες διαστάσεις της τελικής σελίδας μετά την περικοπή και το ArtBox ορίζει την έκταση του ουσιαστικού περιεχομένου της σελίδας (page's meaningful content), όπως προβλέπεται από τον δημιουργό της σελίδας (page's creator)

Συμπεριφορά εκδόσεων PDF: οι εγγραφές BleedBox, TrimBox και ArtBox του λεξικού σελίδας απαιτούν PDF 1.3. Όταν το Direct Access τροποποιεί πηγή χαμηλότερης έκδοσης και η έκδοση αποθήκευσης δεν είναι κλειδωμένη, το DASetPageBox ανεβάζει την κεφαλίδα του αποθηκευμένου εγγράφου σε PDF 1.3 ώστε να ταιριάζει με τις νέες εγγραφές κουτιών ορίων.

Σύνταξη

Delphi

Function TPDFlib.DASetPageBox(FileHandle, PageRef, BoxIndex: Integer; X1, Y1, X2, Y2: Double): Integer;

ActiveX

Function PDFlib::DASetPageBox(FileHandle As Long, PageRef As Long, BoxIndex As Long, X1 As Double, Y1 As Double, X2 As Double, Y2 As Double) As Long

DLL

int DLDASetPageBox(int InstanceID, int FileHandle, int PageRef, int BoxIndex, double X1, double Y1, double X2, double Y2);

Παράμετροι

FileHandle	Handle που επιστρέφουν οι συναρτήσεις DAOpenFile, DAOpenFileReadOnly ή DAOpenFromStream
PageRef	Μια αναφορά σελίδας που επιστρέφεται από τις συναρτήσεις DAFindPage ή DANewPage
BoxIndex	1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1	Η οριζόντια συντεταγμένη της κάτω αριστερής γωνίας του box μετρημένη σε points από την αριστερή πλευρά της σελίδας
Y1	Η κατακόρυφη συντεταγμένη της κάτω αριστερής γωνίας του πλαισίου, μετρημένη σε points από το κάτω μέρος της σελίδας
X2	Η οριζόντια συντεταγμένη της επάνω δεξιάς γωνίας του πλαισίου, μετρημένη σε σημεία από το κάτω μέρος της σελίδας
Y2	Η κατακόρυφη συντεταγμένη της πάνω δεξιάς γωνίας του box μετρημένη σε points από τον πάτο της σελίδας

Τιμές επιστροφής

0	Οι παράμετροι FileHandle ή PageRef ήταν άκυρες
1	Success