RenderPageToMetafileStream
Rendering and printing
Description
Αυτή η συνάρτηση είναι διαθέσιμη μόνο στην έκδοση Delphi· αποδίδει μια σελίδα από το επιλεγμένο έγγραφο σε ένα TStream ως Windows metafile (διανυσματική έξοδος), διατηρώντας το κείμενο και το διανυσματικό περιεχόμενο της σελίδας αντί να το ψηφιοποιεί σε pixel
Η επιλεγμένη μορφή (Format) ελέγχει την παραλλαγή metafile: το mfEMF χρησιμοποιεί την κλασική διαδρομή enhanced-metafile GDI (ευρεία συμβατότητα καταναλωτών), τα mfEMFPlus και mfEMFDual χρησιμοποιούν τη διαδρομή εγγραφής GDI+ (καλύτερη πιστότητα για διαφάνεια και εξομάλυνση περιγραμμάτων), και το mfWMF παράγει την κληροδοτημένη μορφή 16-bit
Το mfEMFDual καταγράφει εντολές GDI και GDI+ στο ίδιο αρχείο, έτσι ώστε παλαιότεροι καταναλωτές μόνο με GDI να μπορούν ακόμα να το διαβάσουν με κόστος μεγαλύτερο μέγεθος αρχείου· προτιμήστε το mfEMFPlus όταν γνωρίζετε ότι ο καταναλωτής έχει δυνατότητα GDI+ (Office, Illustrator, σύγχρονα προγράμματα προβολής)
Εσωτερικά, αυτό είναι ένας βολικός βοηθός (convenience wrapper) πάνω από το RenderPageToStream που αντιστοιχίζει το Format σε μια ακέραιη τιμή Options, επομένως το DPI εξακολουθεί να πολλαπλασιάζεται με το RenderScale ανά παρουσία που ορίζεται μέσω του SetRenderScale
Syntax
Delphi
Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;Parameters
| DPI | Το DPI που θα χρησιμοποιηθεί κατά την απόδοση της σελίδας· ελέγχει τις διαστάσεις του πλαισίου metafile· το ίδιο το διανυσματικό περιεχόμενο είναι ανεξάρτητο από το DPI |
|---|---|
| Page | Ο αριθμός σελίδας προς απόδοση |
| Format | mfEMF = κλασικό GDI EMF· mfEMFPlus = GDI+ EMF+ Only· mfEMFDual = GDI+ EMF+ Dual (εγγραφές GDI + GDI+, μεγαλύτερο αλλά ευρέως συμβατό)· mfWMF = κληροδοτημένο 16-bit WMF |
| Target | Η ροή στην οποία θα τοποθετηθούν τα αποδοθέντα byte του metafile |
Return values
| 0 | Η σελίδα δεν μπόρεσε να αποδοθεί |
|---|---|
| 1 | Η σελίδα αποδόθηκε σωστά και τα byte του metafile γράφτηκαν στη ροή |