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

เอกสารทุกไฟล์จะเปิดด้วยการใช้งาน BaseConfig ส่งออบเจ็กต์นี้ไปยัง OpenDocumentAsync (หรือ OpenDocument) หรือให้แคตาล็อกรูปแบบสร้างค่าเริ่มต้นของมันเอง คลาสทั้งหมดด้านล่างอยู่ในเนมสเปซ 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.

ExcelConfig

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

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

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

PptConfig

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

ติดตั้งฟอนต์ที่งานนำเสนอใช้บนเซิร์ฟเวอร์, หรือชี้ FontFolders ไปยังโฟลเดอร์ที่เก็บฟอนต์เหล่านั้น. Windows Server ที่ไม่มี Office จะมีฟอนต์น้อยกว่าคอมพิวเตอร์สำหรับพัฒนามาก, และฟอนต์ที่หายไปจะถูกทดแทนโดยไม่มีข้อผิดพลาดใด ๆ.

CadConfig

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

EmailConfig

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

ImageConfig, TiffConfig, and 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. ในแพ็กเกจนี้ไฟล์ DICOM จะถูกแสดงผลเต็มรูปแบบ, แต่ข้อมูลเมตาเทคนิคไม่พร้อมใช้งาน — ดูที่ DICOM Plugin.

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, and XpsConfig

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

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

BaseConfig[] configs =
{
    new PdfConfig
    {
        AllowSearch = true,
        ExtractHyperlinks = true,
        HyperlinksPageCount = 0
    },
    new WordConfig
    {
        PaperSize = DocPaperSize.A4,
        RemovePaperMargin = false,
        FontFolders = new[] { HostingEnvironment.MapPath("~/App_Data/Fonts") },
        AllowSearch = true
    },
    new ExcelConfig
    {
        PaperLandscape = true,
        AutoFitContents = true,
        CalculateFormula = true,
        SplitWorksheets = false,
        PrintGridlines = false
    },
    new PptConfig
    {
        FastLoad = true,
        FontFolders = new[] { HostingEnvironment.MapPath("~/App_Data/Fonts") },
        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)
{
    switch (extUpper)
    {
        case ".DOC": case ".DOCX": case ".DOT": case ".DOTX": case ".ODT":
            return new WordConfig
            {
                AutoFitAllTables = WordConfig.TableAutoFitBehavior.AutoFitToWindow,
                PaperSize = DocPaperSize.Tabloid,
                PdfConfig = new PdfConfig { ExtractHyperlinks = true, HyperlinksPageCount = 5, AllowCopy = true }
            };
        case ".PDF":
            return new PdfConfig { AllowSearch = true, AllowCopy = true };
        case ".XLS": case ".XLSX": case ".ODS": case ".CSV":
            return new ExcelConfig { AllowSearch = true, AllowCopy = true };
        case ".DCM": case ".IMA":
            return new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames };
        // DefaultRender = false → PDF redirect → pixel-accurate native text search
        case ".HTML": case ".HTM":
            return new HtmlConfig { DefaultRender = false };
        case ".EML": case ".EMLX": case ".MSG":
            return new EmailConfig { DefaultRender = false };
        default:
            return null; // fall back to the format's default config
    }
}