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

ตัวเลือกการเรนเดอร์ต่อรูปแบบแบบครบถ้วน

เอกสารทุกฉบับเปิดด้วยการใช้งาน 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ปรับขนาดภาพที่ฝังอยู่ก่อนการเรนเดอร์.
intResizeResolution300DPI เป้าหมายสำหรับภาพที่ปรับขนาด.
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.

การตั้งค่า Excel

รูปแบบ: 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>SheetNamesemptyจำกัดการเรนเดอร์ให้กับเวิร์กชีตที่มีชื่อเท่านั้น.
CustomStyleCell?CustomStylesnullการแทนที่รูปแบบวันที่/ทศนิยม/จำนวนเต็มแบบเลือกได้.
boolAllowSearchfalseมอบหมายให้ PdfConfig.AllowSearch.
boolAllowCopyfalseมอบหมายให้ PdfConfig.AllowCopy.

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

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

การตั้งค่า PPT

รูปแบบ: 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 ไม่จำเป็น).

การตั้งค่า CAD

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

ประเภทคุณสมบัติค่าเริ่มต้นพฤติกรรม
boolDefaultRendertrueการเรนเดอร์ CAD แบบดั้งเดิม; false ใช้การเปลี่ยนเส้นทางเป็น PDF.
PdfConfigPdfConfigอินสแตนซ์ใหม่การตั้งค่าเส้นทาง PDF.
boolExportPdfAfalseผลลัพธ์ PDF/A เพื่อการเก็บถาวร.
boolShowColortrueสีแทนการขาว-ดำ.
boolWhiteBackgroundtrueพื้นหลังสีขาวแทนสีดำ.
shortLineWidth25ความกว้างของเส้น CAD.
boolShowLayoutsfalseเรนเดอร์แท็บเลย์เอาต์.
boolShowModeltrueเรนเดอร์พื้นที่โมเดล.
boolCheck3DSolidtrueประมวลผลโซลิด 3 มิติ.
boolExportAllLayoutsfalseส่งออกทุกเลย์เอาต์, ลบการเลือกโมเดล/เลย์เอาต์.
boolLimitMinimumSizefalseใช้ MinimumSize.
intMinimumSize700ขนาดผลลัพธ์ขั้นต่ำเป็นพิกเซล.
boolLimitMaximumSizefalseใช้ MaximumSize.
intMaximumSize700ขนาดผลลัพธ์สูงสุดเป็นพิกเซล.
boolShowAllLayoutsDgnfalseรวมทุกเลย์เอาต์ DGN.
boolAutomaticLayoutScalingtrueปรับขนาดเลย์เอาต์โดยอัตโนมัติ.
floatPdfMargins0.5ระยะขอบ PDF เป็นนิ้ว.
RenderQualityQualityImageLowคุณภาพเรสเตอร์: Low, Medium, หรือ High.
RenderQualityQualityTextMediumคุณภาพข้อความ: Low, Medium, หรือ High.

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

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

ประเภทคุณสมบัติค่าเริ่มต้นพฤติกรรม
boolDefaultRendertrueการแสดงผลอีเมลแบบดั้งเดิม; false ใช้การเปลี่ยนเส้นทางเป็น PDF.
PdfConfigPdfConfigอินสแตนซ์ใหม่การตั้งค่าเส้นทาง PDF.
Encoding?EmailEncodingnullแทนที่การเข้ารหัสข้อความ.
Encoding?SubjectEncodingnullแทนที่การเข้ารหัสหัวเรื่อง.
Encoding?BodyEncodingnullแทนที่การเข้ารหัสเนื้อหา.
boolSkipExternalImagesfalseไม่โหลดรูปภาพที่อ้างอิงจากระยะไกล. แนะนำสำหรับอีเมลที่ไม่เชื่อถือ.
boolRemoveLastWhitePagefalseลบหน้าว่างที่ต่อท้าย.
boolUseAntiAliasingfalseเปิดใช้งานการลบรอยหยัก.
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 ที่มีประสิทธิภาพDPI แนวนอนโดยตรง; หากไม่ระบุจะใช้ ImageResolution, จากนั้น 100.
intVerticalResolution100 ที่มีประสิทธิภาพDPI แนวตั้งโดยตรง; หากไม่ระบุจะใช้ ImageResolution, จากนั้น 100.
intAnimationFrameDelayMs100ความหน่วงของแอนิเมชันหลายเฟรม; การจับเวลา GIF ใช้หน่วย 10 มิลลิวินาที.
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 ที่ซ้อนกัน.

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

หน้านี้เป็นประโยชน์หรือไม่?