การกำหนดค่าแบบฟอร์ม

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

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.

การกำหนดค่าอีเมล

รูปแบบ: 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 = ["/usr/share/fonts/truetype"],
        AllowSearch = true
    },
    new ExcelConfig
    {
        PaperLandscape = true,
        AutoFitContents = true,
        CalculateFormula = true,
        SplitWorksheets = false,
        PrintGridlines = false
    },
    new PptConfig
    {
        FastLoad = true,
        FontFolders = ["/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 redirect → การค้นหาข้อความแบบเนทีฟที่แม่นยำระดับพิกเซล
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // กลับไปใช้การกำหนดค่าเริ่มต้นของรูปแบบ’s default config
};