Διαμορφώσεις Μορφής

Πλήρεις επιλογές απόδοσης ανά μορφή

Κάθε έγγραφο ανοίγει με μια υλοποίηση BaseConfig. Περάστε ένα στο OpenDocumentAsync ή αφήστε τον κατάλογο μορφών να δημιουργήσει το προεπιλεγμένο. Όλες οι παρακάτω κλάσεις ζουν στον χώρο ονομάτων Doconut.

csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true,
    ImageResolution = 150
});

Κληρονομικότητα και ενσωματωμένες ρυθμίσεις PDF

Κάθε μορφή κληρονομεί τις πέντε ιδιότητες BaseConfig. Οι μορφές που μπορούν να ανακατευθύνουν μέσω PDF εκθέτουν μια ενσωματωμένη PdfConfig. Στα WordConfig, ExcelConfig και PptConfig, οι AllowSearch και AllowCopy είναι ιδιότητες ευκολίας που διαβάζουν και γράφουν την ενσωματωμένη PdfConfig.

DefaultRender = true επιλέγει τον εγγενή αποδοχέα μορφής. Σε μορφές με ανακατεύθυνση PDF, false μετατρέπει πρώτα σε PDF στη μνήμη και στη συνέχεια χρησιμοποιεί τον προβολέα PDF. Αυτή η διαδρομή είναι συχνά χρήσιμη για αναζήτηση κειμένου με συντεταγμένες, αλλά κοστίζει μια επιπλέον μετατροπή.

Εκτός εάν αναφέρεται διαφορετικά, οι πίνακες δείχνουν τις προεπιλογές κατασκευής/ιδιοτήτων. Ο αυτόματος κατάλογος μορφών παρακάμπτει σκόπιμα δύο από αυτές: δημιουργεί ExcelConfig με SplitWorksheets = true και MhtConfig με DefaultRender = false.

BaseConfig

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
intImageResolution00 χρησιμοποιεί την προεπιλογή της μορφής. Έγκυρο ρητό εύρος είναι 25-300 DPI· οι μη έγκυρες εκχωρήσεις αγνοούνται.
stringDocumentCulture""Περιοχή για ημερομηνίες και αριθμούς. Οι μη κενές τιμές περικόπτονται· οι κενές εκχωρήσεις αγνοούνται.
stringPassword""Κωδικός πρόσβασης προστατευμένου εγγράφου. DocOptions.Password αντιγράφεται εδώ αυτόματα.
boolShowUItrueΙδιότητα συμβατότητας· ο τρέχων αποδοχέας δεν τη χρησιμοποιεί για έλεγχο της γραμμής εργαλείων του προγράμματος περιήγησης.
boolCachePagestrueΑποθήκευση στην κρυφή μνήμη των εικόνων σελίδων που αποδόθηκαν για τη συνεδρία του εγγράφου.

PdfConfig

Μορφές: PDF. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΔιακόπτης συμβατότητας. Η τρέχουσα εργοστασιακή μονάδα χρησιμοποιεί τον εγγενή προβολέα PDF.
boolAllowSearchfalseΔημιουργία/χρήση του ευρετηρίου αναζήτησης κειμένου PDF. Απαιτεί τη δυνατότητα άδειας Search για αιτήματα.
boolAllowCopyfalseΕπιτρέπει λειτουργίες επιλογής/αντιγραφής κειμένου.
boolExtractHyperlinksfalseΕξάγει τα ορθογώνια συνδέσμων για επικάλυψη πελάτη.
intHyperlinksPageCount0Μέγιστος αριθμός σελίδων που σαρώνονται για συνδέσμους· 0 σημαίνει κάθε σελίδα.
boolCompressImagesfalseΣυμπίεση ενσωματωμένων εικόνων πριν την απόδοση.
intCompressQuality100Ποιότητα JPEG που χρησιμοποιείται όταν η συμπίεση είναι ενεργοποιημένη.
boolResizeImagesfalseΑλλαγή μεγέθους ενσωματωμένων εικόνων πριν την απόδοση.
intResizeResolution300Στόχος DPI για τις εικόνες που έχουν αλλάξει μέγεθος.
boolCompressFastfalseΠροτιμά τη γρηγορότερη, χαμηλότερης ποιότητας διαδρομή συμπίεσης.
boolFixInvalidImagesfalseΠροσπάθεια επισκευής μη έγκυρων ενσωματωμένων εικόνων.
boolSplitSegmentsfalseΕπανασύνδεση λέξεων που χωρίστηκαν σε τμήματα γραμμής για βελτίωση της αναζήτησης/αντιγραφής.

showHyperlinks στο ViewerConfig ελέγχει την επικάλυψη πελάτη, ενώ ExtractHyperlinks ελέγχει την εξαγωγή διακομιστή. Ενεργοποιήστε και τα δύο.

WordConfig

Μορφές: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική απόδοση Word· false χρησιμοποιεί την ανακατεύθυνση PDF.
PdfConfigPdfConfignew instanceΡυθμίσεις που χρησιμοποιούνται από τη διαδρομή PDF/αναζήτησης.
DocPaperSizePaperSizeA4Μέγεθος εξόδου χαρτιού. Χρησιμοποιήστε Custom με πλάτος/ύψος.
intPaperWidth595Προσαρμοσμένο πλάτος σε σημεία.
intPaperHeight841Προσαρμοσμένο ύψος σε σημεία.
boolRemovePaperMarginfalseΑφαίρεση περιθωρίων σελίδας εγγράφου.
boolRenderPageColortrueΔιατήρηση του ρυθμισμένου χρώματος σελίδας του Word· false αποδίδει λευκές σελίδες.
boolExportPdfAfalseΧρήση αρχιβιακού PDF/A στη διαδρομή PDF.
Encoding?FileEncodingnullΠαράκαμψη κωδικοποίησης πηγής.
stringFontInfo""Πληροφορίες αντικατάστασης γραμματοσειράς.
string[]?FontFoldersnullΠρόσθετοι φάκελοι γραμματοσειρών, ιδιαίτερα χρήσιμοι σε Linux/containers.
boolAllowSearchfalseΑναθέτει στο PdfConfig.AllowSearch.
boolAllowCopyfalseΑναθέτει στο PdfConfig.AllowCopy.
TableAutoFitBehaviorAutoFitAllTablesNoneNone, AutoFitToContents ή AutoFitToWindow.

ExcelConfig

Μορφές: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική απόδοση φύλλου· false χρησιμοποιεί την ανακατεύθυνση PDF.
PdfConfigPdfConfigνέα παρουσίαΡυθμίσεις για τη διαδρομή PDF/αναζήτησης.
ExcelPaperSizePaperSizePaperA4Μέγεθος χαρτιού εξόδου.
doublePaperMargins0.25Περιθώρια σελίδας σε ίντσες.
boolPaperLandscapetrueΑπόδοση φύλλου οριζόντιας διάταξης.
boolAutoFitContentsfalseΑυτόματη προσαρμογή ύψους γραμμών και πλάτους στηλών.
boolRemoveEmptyContenttrueΣυμπίεση εξόδου αποκλείοντας κενό περιεχόμενο.
boolCalculateFormulatrueΕπανυπολογισμός τύπων πριν την απόδοση.
boolShowRowColumnHeaderstrueΣυμπερίληψη κεφαλίδων υπολογιστικού φύλλου.
boolExportPdfAfalseΧρήση PDF/A στη διαδρομή PDF.
boolSplitWorksheetsfalseΔιατήρηση φύλλων εργασίας ως ξεχωριστές ομάδες σελίδων.
boolShowEmptyWorkSheetsfalseΣυμπερίληψη κενών φύλλων εργασίας.
boolExportLandscapefalseΕξαναγκασμός εξαγωγής οριζόντιας διάταξης.
boolExportOnePagePerSheetfalseΠροσαρμογή κάθε φύλλου εργασίας σε μία σελίδα εξόδου.
boolMemoryOptimizationPreferencetrueΜείωση μέγιστης μνήμης, ενδεχομένως με ανταλλαγή κάποιου χρόνου.
boolAutoTrimWorksheetRenderRangetrueΑπόδοση μόνο του ορατού χρησιμοποιημένου εύρους όταν δεν υπάρχει ρητή περιοχή εκτύπωσης.
boolAutoTrimPreserveExistingPrintAreatrueΔιατήρηση περιοχών εκτύπωσης που ορίζονται από το βιβλίο εργασίας κατά το αυτόματο περικοπή.
string?PrintAreanullΡητό εύρος όπως το "A1:Z100".
boolPrintGridlinesfalseΕκτύπωση γραμμών πλέγματος φύλλου εργασίας.
boolPrintHeadingsfalseΕκτύπωση επικεφαλίδων γραμμών/στηλών.
List<string>SheetNamesκενόΠεριορισμός απόδοσης σε ονομασμένα φύλλα εργασίας.
CustomStyleCell?CustomStylesnullΠροαιρετικές παρακάμψεις μορφοποίησης ημερομηνίας/δεκαδικού/ακέραιου.
boolAllowSearchfalseΑναθέτει στο PdfConfig.AllowSearch.
boolAllowCopyfalseΑναθέτει στο PdfConfig.AllowCopy.

CustomStyleCell αποκαλύπτει CustomStyleDateTime, CustomStyleNumberDecimal και CustomStyleNumberInteger, όλες οι nullable strings.

new ExcelConfig() ορίζει SplitWorksheets σε false· το άνοιγμα ενός αρχείου Excel χωρίς ρητή διαμόρφωση χρησιμοποιεί τον κατάλογο μορφών, ο οποίος το ορίζει σε true.

PptConfig

Μορφές: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική απόδοση διαφάνειας· false χρησιμοποιεί την ανακατεύθυνση PDF.
boolFastLoadfalseΑποφυγή απόδοσης της πρώτης διαφάνειας κατά το άνοιγμα· χρήση μεταδεδομένων και απόδοση κατόπιν ζήτησης.
PdfConfigPdfConfigνέα παρουσίαΡυθμίσεις για τη συμπεριφορά PDF/αναζήτησης.
stringFontInfo""Πληροφορίες αντικατάστασης γραμματοσειρών.
string[]?FontFoldersnullΕπιπλέον καταλόγοι γραμματοσειρών.
boolAllowSearchfalseΑναθέτει στο PdfConfig.AllowSearch.
boolAllowCopyfalseΑναθέτει στο PdfConfig.AllowCopy.

Οι σελίδες σχεδιάζονται με τις γραμματοσειρές που είναι εγκατεστημένες στον διακομιστή. Σε Linux, εγκαταστήστε τις γραμματοσειρές που χρησιμοποιούν οι παρουσιάσεις ή κατευθύνετε FontFolders σε αυτές: μια ελλιπής γραμματοσειρά αντικαθίσταται χωρίς σφάλμα, έτσι οι αλλαγές γραμμής μπορεί να διαφέρουν από τα Windows. fonts-liberation, fonts-crosextra-carlito και fonts-crosextra-caladea παρέχουν υποκατάστατα συμβατά με το μετρικό σύστημα για τις κοινές γραμματοσειρές των Windows. Το Linux χρειάζεται μόνο libfontconfig1 (το libgdiplus δεν απαιτείται).

CadConfig

Μορφές: DWG, DXF, DGN. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική απόδοση CAD· false χρησιμοποιεί την ανακατεύθυνση PDF.
PdfConfigPdfConfigνέα παρουσίαΡυθμίσεις διαδρομής PDF.
boolExportPdfAfalseΑρχιβοθέτηση εξόδου PDF/A.
boolShowColortrueΧρώμα αντί για μονόχρωμο.
boolWhiteBackgroundtrueΛευκό αντί για μαύρο φόντο.
shortLineWidth25Πλάτος γραμμής CAD.
boolShowLayoutsfalseΑπόδοση καρτελών διάταξης.
boolShowModeltrueΑπόδοση χώρου μοντέλου.
boolCheck3DSolidtrueΕπεξεργασία στερεών 3D.
boolExportAllLayoutsfalseΕξαγωγή όλων των διατάξεων, παρακάμπτοντας την επιλογή μοντέλου/διάταξης.
boolLimitMinimumSizefalseΕφαρμογή του MinimumSize.
intMinimumSize700Ελάχιστο μέγεθος εξόδου σε εικονοστοιχεία.
boolLimitMaximumSizefalseΕφαρμογή του MaximumSize.
intMaximumSize700Μέγιστο μέγεθος εξόδου σε εικονοστοιχεία.
boolShowAllLayoutsDgnfalseΣυμπερίληψη όλων των διατάξεων DGN.
boolAutomaticLayoutScalingtrueΑυτόματη κλιμάκωση διατάξεων.
floatPdfMargins0.5Περιθώριο PDF σε ίντσες.
RenderQualityQualityImageLowΠοιότητα ραστερ: Low, Medium ή High.
RenderQualityQualityTextMediumΠοιότητα κειμένου: Low, Medium ή High.

EmailConfig

Μορφές: EML, EMLX, MSG. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική απόδοση email· false χρησιμοποιεί την ανακατεύθυνση PDF.
PdfConfigPdfConfigνέα παρουσίαΡυθμίσεις διαδρομής PDF.
Encoding?EmailEncodingnullΠαράκαμψη κωδικοποίησης μηνύματος.
Encoding?SubjectEncodingnullΠαράκαμψη κωδικοποίησης θέματος.
Encoding?BodyEncodingnullΠαράκαμψη κωδικοποίησης σώματος.
boolSkipExternalImagesfalseΝα μην φορτώνονται εικόνες απομακρυσμένα αναφερόμενες. Συνιστάται για μη αξιόπιστο email.
boolRemoveLastWhitePagefalseΑφαίρεση τελικής κενής σελίδας.
boolUseAntiAliasingfalseΕνεργοποίηση anti-aliasing.
boolUseHighQualityRenderingfalseΠροτίμηση καθαρότερης, πιο αργής απόδοσης.
TimeSpan?TimeZoneOffsetnullΠαράκαμψη της ζώνης ώρας που χρησιμοποιείται για ημερομηνίες.
boolForcePageSizefalseΕξαναγκασμός σταθερών διαστάσεων σελίδας.

ImageConfig, TiffConfig και PsdConfig

Το ImageConfig καλύπτει JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF και SVG. Το προεπιλεγμένο DPI του είναι 100.

ΔιαμόρφωσηΙδιότηταΠροεπιλογήΣυμπεριφορά
ImageConfigMaxImagePixelSize3000Μέγιστο πλάτος/ύψος. 0 σημαίνει απεριόριστο· μη μηδενικές τιμές κάτω από 50 αγνοούνται.
ImageConfigTransparentPngtrueΔιατήρηση διαφάνειας PNG· false χρησιμοποιεί λευκό φόντο.
TiffConfigχωρίς πρόσθετες ιδιότητεςDPI 200Χρησιμοποιεί μόνο BaseConfig· υποστηρίζει πολυ-σελίδες TIFF.
PsdConfigMaxImagePixelSize3000Ίδια επικύρωση 0/minimum-50 όπως ImageConfig· το προεπιλεγμένο DPI είναι 100.

DicomConfig

Μορφές: DCM, IMA. Προεπιλεγμένο ενεργό DPI: 100. Απαιτεί το πρόσθετο DICOM. Σε αυτό το πακέτο τα αρχεία DICOM αποδίδονται πλήρως, αλλά τα τεχνικά μεταδεδομένα δεν είναι διαθέσιμα — δείτε Πρόσθετο DICOM.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
intHorizontalResolution100 effectiveΣαφές οριζόντιο DPI· διαφορετικά ImageResolution, έπειτα 100.
intVerticalResolution100 effectiveΣαφές κάθετο DPI· διαφορετικά ImageResolution, έπειτα 100.
intAnimationFrameDelayMs100Καθυστέρηση animation πολλαπλών καρέ· ο χρόνος GIF χρησιμοποιεί μονάδες 10 ms.
ushortLoopCount00 επαναλαμβάνεται επ' άπειρο· θετικές τιμές σταματούν μετά από αυτόν τον αριθμό.
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly, FramesOnly, ή συνδυασμένη επισκόπηση συν στατικά καρέ.

TxtConfig

Μορφή: TXT. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
DocPaperSizePaperSizeA4Μέγεθος εξόδου χαρτιού.
Encoding?FileEncodingnullnull χρησιμοποιεί UTF-8.
stringFontInformation""Πληροφορίες γραμματοσειράς για απόδοση κειμένου.

Χρησιμοποιήστε WordConfig όταν το απλό κείμενο χρειάζεται πιο πλούσια συμπεριφορά διάταξης σελίδας.

ProjectConfig

Μορφές: MPP, MPPX, MPX. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική εικόνα Gantt· false χρησιμοποιεί διαδρομή PDF κειμένου.
PdfConfigPdfConfigνέα παρουσίαΡυθμίσεις διαδρομής PDF.
boolExportPdfAtrueΈξοδος PDF/A αρχειοθέτησης.
MppPaperSizePaperSizeLedgerΜέγεθος εξόδου χαρτιού του έργου.
MppTimeScaleTimeScaleMonthsDays ή Months.
MppFormatPresentationFormatGanttChartGanttChart, TaskUsage, ResourceUsage, ResourceSheet, ή TaskSheet.

Για ακριβή αναζήτηση συντεταγμένων κειμένου, χρησιμοποιήστε DefaultRender = false.

VisioConfig

Μορφές: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. Προεπιλεγμένο DPI: 200.

ΤύποςΙδιότηταΠροεπιλογήΣυμπεριφορά
boolDefaultRendertrueΑυθεντική απόδοση διαγράμματος· false χρησιμοποιεί την ανακατεύθυνση PDF.
PdfConfigPdfConfigνέα παρουσίαΡυθμίσεις διαδρομής PDF.
boolExportPdfAtrueΈξοδος PDF/A αρχειοθέτησης.

HtmlConfig, EpubConfig, MhtConfig και XpsConfig

Τα τέσσερα προεπιλεγμένα σε DPI 200 και εκθέτουν ένα ένθετο PdfConfig.

ConfigFormatsDefaultRenderΠρόσθετες ιδιότητες/συμπεριφορά
HtmlConfigHTML, HTMtrueΑυθεντική απόδοση· χρησιμοποιήστε false για διαδρομή αναζήτησης PDF κειμένου.
EpubConfigEPUBtrueΑυθεντική απόδοση· false χρησιμοποιεί PDF.
MhtConfigMHT, MHTMLtrue στην κλάση· false στο αυτόματο κατάλογοΗ κανονική άνοιγμα χωρίς ρύθμιση χρησιμοποιεί την ανακατεύθυνση PDF αναζητήσιμη. Μια ρητά κατασκευασμένη προεπιλεγμένη παρουσίαση αποδίδει αυθεντικά.
XpsConfigXPSfalseΧρησιμοποιεί τη διαδρομή PDF εξ ορισμού· ορίστε true για αυθεντική απόδοση εικόνας.

Παραδείγματα διαμόρφωσης ανά οικογένεια

csharp
BaseConfig[] configs =
{
    new PdfConfig
    {
        AllowSearch = true,
        ExtractHyperlinks = true,
        HyperlinksPageCount = 0
    },
    new WordConfig
    {
        PaperSize = DocPaperSize.A4,
        RemovePaperMargin = false,
        FontFolders = new[] { "/usr/share/fonts/truetype" },
        AllowSearch = true
    },
    new ExcelConfig
    {
        PaperLandscape = true,
        AutoFitContents = true,
        CalculateFormula = true,
        SplitWorksheets = false,
        PrintGridlines = false
    },
    new PptConfig
    {
        FastLoad = true,
        FontFolders = new[] { "/usr/share/fonts/truetype" },
        AllowSearch = true
    },
    new CadConfig
    {
        ShowColor = true,
        WhiteBackground = true,
        ShowModel = true,
        ShowLayouts = false,
        QualityText = CadConfig.RenderQuality.High
    },
    new EmailConfig
    {
        SkipExternalImages = true,
        RemoveLastWhitePage = true,
        TimeZoneOffset = TimeSpan.Zero
    },
    new ImageConfig
    {
        MaxImagePixelSize = 3000,
        TransparentPng = true
    },
    new DicomConfig
    {
        DisplayMode = DicomDisplayMode.AnimationAndFrames,
        AnimationFrameDelayMs = 100,
        LoopCount = 0
    }
};

Επιλογή ανά επέκταση

csharp
static BaseConfig? ConfigForExtension(string extUpper) => extUpper switch
{
    ".DOC" or ".DOCX" or ".DOT" or ".DOTX" or ".ODT" => new WordConfig
    {
        AutoFitAllTables = WordConfig.TableAutoFitBehavior.AutoFitToWindow,
        PaperSize = DocPaperSize.Tabloid,
        PdfConfig = new PdfConfig { ExtractHyperlinks = true, HyperlinksPageCount = 5, AllowCopy = true }
    },
    ".PDF" => new PdfConfig { AllowSearch = true, AllowCopy = true },
    ".XLS" or ".XLSX" or ".ODS" or ".CSV" => new ExcelConfig { AllowSearch = true, AllowCopy = true },
    ".DCM" or ".IMA" => new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames },
    // DefaultRender = false → PDF redirect → pixel-ακριβής αυθεντική αναζήτηση κειμένου
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // επιστρέψτε στην προεπιλεγμένη διαμόρφωση του format
};

Ήταν αυτή η σελίδα χρήσιμη;