การกำหนดค่ารูปแบบ

ทุกเอกสารจะเปิดด้วยการทำงานของ BaseConfig. ส่งหนึ่งไปยัง OpenDocumentAsync หรือให้แคตตาล็อกรูปแบบสร้างค่าเริ่มต้นของมันเอง. คลาสทั้งหมดด้านล่างอยู่ในเนมสเปซ Doconut.

เนมสเปซเดียวนี้เป็นใหม่. ไลบรารี .NET Standard ก่อนหน้านี้กระจายประเภทเหล่านี้ไปยัง Doconut.Configs, Doconut.Configs.View, และ Doconut.Models. ชื่อประเภทไม่ได้ เปลี่ยน — ในไฟล์ส่วนใหญ่การแก้ไขทั้งหมดคือการลบสองบรรทัดของ using. ดู คู่มือการย้าย.

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

PdfConfig

รูปแบบ: PDF. DPI เริ่มต้น: 200.

showHyperlinks ใน ViewerConfig ควบคุมการวางซ้อนของไคลเอนต์, ในขณะที่ ExtractHyperlinks ควบคุมการสกัดของเซิร์ฟเวอร์. เปิดใช้งานทั้งสอง.

WordConfig

รูปแบบ: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. DPI เริ่มต้น: 200.

การกำหนดค่า Excel

รูปแบบ: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. ค่า DPI เริ่มต้น: 200.

CustomStyleCell เปิดเผย CustomStyleDateTime, CustomStyleNumberDecimal, และ CustomStyleNumberInteger, ทั้งหมดเป็นสตริงที่เป็นค่า null ได้.

new ExcelConfig() ตั้งค่า SplitWorksheets เป็น false; การเปิดไฟล์ Excel โดยไม่มีการกำหนดค่าอย่างชัดเจนจะใช้แคตาล็อกรูปแบบ ซึ่งตั้งค่าเป็น true.

การกำหนดค่า PPT

รูปแบบ: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. ค่า DPI เริ่มต้น: 200.

บน Linux และ macOS การแสดงงานนำเสนอด้วยเอนจินปัจจุบันต้องการ libgdiplus และ System.Drawing.EnableUnixSupport=true. ติดตั้งฟอนต์ที่งานนำใช้หรือจัดหา FontFolders.

การกำหนดค่า CAD

รูปแบบ: DWG, DXF, DGN. ค่า DPI เริ่มต้น: 200.

EmailConfig

รูปแบบ: EML, EMLX, MSG. DPI เริ่มต้น: 200.

ImageConfig, TiffConfig, และ PsdConfig

ImageConfig รองรับ JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF, และ SVG. DPI เริ่มต้นของมันคือ 100.

DicomConfig

รูปแบบ: DCM, IMA. DPI มีประสิทธิภาพเริ่มต้น: 100. ต้องการปลั๊กอิน DICOM.

TxtConfig

รูปแบบ: TXT. DPI เริ่มต้น: 200.

ใช้ WordConfig เมื่อข้อความธรรมดาต้องการพฤติกรรมการจัดหน้าแบบละเอียดมากขึ้น.

ProjectConfig

รูปแบบ: MPP, MPPX, MPX. DPI เริ่มต้น: 200.

สำหรับการค้นหาโดยพิกัดข้อความที่แม่นยำ, ใช้ DefaultRender = false.

VisioConfig

รูปแบบ: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. DPI เริ่มต้น: 200.

HtmlConfig, EpubConfig, MhtConfig, และ XpsConfig

สี่รายการนี้ทั้งหมดตั้งค่าเริ่มต้นเป็น DPI 200 และเปิดเผย PdfConfig ที่ซ้อนกัน.

ตัวอย่างการกำหนดค่าโดยกลุ่ม

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
    }
};

การเลือกตามส่วนขยาย

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 รีไดเรกต์ → การค้นหาข้อความเนทีฟที่แม่นยำระดับพิกเซล
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // กลับไปใช้ config เริ่มต้นของรูปแบบ
};