フォーマット設定

フォーマットごとの完全なレンダリングオプション

すべてのドキュメントは BaseConfig 実装で開きます。OpenDocumentAsync に渡すか、フォーマットカタログにデフォルトを作成させます。以下のすべてのクラスは Doconut 名前空間にあります。

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

継承とネストされた PDF 設定

すべてのフォーマットは 5 つの BaseConfig プロパティを継承します。PDF を介してリダイレクトできるフォーマットはネストされた PdfConfig を公開します。WordConfig、ExcelConfig、PptConfig では、AllowSearch と AllowCopy はネストされた PdfConfig を読み書きする便利なプロパティです。

DefaultRender = true はネイティブフォーマットレンダラを選択します。PDF リダイレクトがあるフォーマットでは、false が最初にインメモリ PDF に変換し、次に PDF ビューアを使用します。そのパスはテキスト座標検索に便利ですが、余分な変換コストがかかります。

特に記載がない限り、表はコンストラクタ/プロパティのデフォルトを示しています。自動フォーマットカタログは意図的にそのうちの 2 つを上書きします:ExcelConfig を SplitWorksheets = true で作成し、MhtConfig を DefaultRender = false で作成します。

BaseConfig

型プロパティデフォルト動作
intImageResolution00 はフォーマットのデフォルトを使用します。有効な明示的範囲は 25-300 DPI です;無効な割り当ては無視されます。
stringDocumentCulture""日付と数値のロケールです。空でない値はトリムされ、空の割り当ては無視されます。
stringPassword""保護されたドキュメントのパスワードです。DocOptions.Password が自動的にここにコピーされます。
boolShowUItrue互換性プロパティです;現在のレンダラはブラウザツールバーの制御に使用しません。
boolCachePagestrueドキュメントセッションのためにレンダリングされたページ画像をキャッシュします。

PdfConfig

フォーマット: PDF。デフォルト DPI: 200。

型プロパティデフォルト動作
boolDefaultRendertrue互換性スイッチです。現在のファクトリはネイティブ PDF ビューアを使用します。
boolAllowSearchfalsePDF テキスト検索インデックスを構築/使用します。リクエストには 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 instancePDF/検索パスで使用される設定です。
DocPaperSizePaperSizeA4出力用紙サイズです。幅/高さには Custom を使用します。
intPaperWidth595ポイント単位のカスタム幅です。
intPaperHeight841ポイント単位のカスタム高さです。
boolRemovePaperMarginfalseドキュメントページの余白を削除します。
boolRenderPageColortrueWord の設定されたページカラーを保持します;false は白いページをレンダリングします。
boolExportPdfAfalsePDF パスでアーカイブ PDF/A を使用します。
Encoding?FileEncodingnullソースエンコーディングを上書きします。
stringFontInfo""フォント置換情報です。
string[]?FontFoldersnull追加のフォントディレクトリです。特に Linux/コンテナで有用です。
boolAllowSearchfalsePdfConfig.AllowSearch に委譲します。
boolAllowCopyfalsePdfConfig.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スプレッドシートのヘッダーを含める。
boolExportPdfAfalsePDF パスで PDF/A を使用。
boolSplitWorksheetsfalseワークシートを別々のページグループとして保持。
boolShowEmptyWorkSheetsfalse空のワークシートも含める。
boolExportLandscapefalse横向きエクスポートを強制。
boolExportOnePagePerSheetfalse各ワークシートを1ページに収める。
boolMemoryOptimizationPreferencetrueピークメモリを削減し、速度が若干低下する可能性があります。
boolAutoTrimWorksheetRenderRangetrue明示的な印刷領域がない場合、表示されている使用範囲のみをレンダリング。
boolAutoTrimPreserveExistingPrintAreatrue自動トリム時にブックで定義された印刷領域を保持。
string?PrintAreanull例として "A1:Z100" のような明示的な範囲。
boolPrintGridlinesfalseワークシートのグリッドラインを印刷。
boolPrintHeadingsfalse行/列の見出しを印刷。
List<string>SheetNames空名前付きワークシートにレンダリングを制限。
CustomStyleCell?CustomStylesnull任意の日付/小数/整数の書式オーバーライド。
boolAllowSearchfalsePdfConfig.AllowSearch に委譲。
boolAllowCopyfalsePdfConfig.AllowCopy に委譲。

CustomStyleCell は CustomStyleDateTime、CustomStyleNumberDecimal、および CustomStyleNumberInteger を公開し、すべて nullable 文字列です。

new ExcelConfig() は SplitWorksheets を false に設定します。明示的な設定なしで Excel ファイルを開くと、フォーマットカタログが使用され、true が設定されます。

PowerPoint設定

フォーマット: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. デフォルト DPI: 200.

型プロパティデフォルト動作
boolDefaultRendertrueネイティブスライドレンダリング; false は PDF リダイレクトを使用します。
boolFastLoadfalse開く際に最初のスライドのレンダリングを回避し、メタデータを使用してオンデマンドでレンダリング。
PdfConfigPdfConfig新しいインスタンスPDF/検索動作の設定。
stringFontInfo""フォント置換情報。
string[]?FontFoldersnull追加のフォントディレクトリ。
boolAllowSearchfalsePdfConfig.AllowSearch に委譲。
boolAllowCopyfalsePdfConfig.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背景を黒ではなく白に。
shortLineWidth25CAD のストローク幅。
boolShowLayoutsfalseレイアウトタブをレンダリング。
boolShowModeltrueモデル空間をレンダリング。
boolCheck3DSolidtrue3D ソリッドを処理。
boolExportAllLayoutsfalseすべてのレイアウトをエクスポートし、モデル/レイアウト選択を上書き。
boolLimitMinimumSizefalseMinimumSize を適用。
intMinimumSize700最小出力サイズ(ピクセル)。
boolLimitMaximumSizefalseMaximumSize を適用。
intMaximumSize700最大出力サイズ(ピクセル)。
boolShowAllLayoutsDgnfalseすべての DGN レイアウトを含める。
boolAutomaticLayoutScalingtrueレイアウトを自動的にスケール。
floatPdfMargins0.5PDF の余白(インチ)。
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 未満の非ゼロ値は無視されます。
ImageConfigTransparentPngtruePNG の透過性を保持します。false は白い背景を使用します。
TiffConfig追加プロパティなしDPI 200BaseConfig のみを使用します;マルチページ TIFF をサポートします。
PsdConfigMaxImagePixelSize3000同じ 0/minimum-50 検証は ImageConfig と同様です;デフォルト DPI は 100 です。

DicomConfig

形式: DCM、IMA。デフォルト有効 DPI: 100. DICOM プラグインが必要です。

タイププロパティデフォルト動作
intHorizontalResolution100 有効明示的な水平 DPI;それ以外は ImageResolution、次に 100。
intVerticalResolution100 有効明示的な垂直 DPI;それ以外は ImageResolution、次に 100。
intAnimationFrameDelayMs100マルチフレームアニメーション遅延;GIF のタイミングは 10 ms 単位を使用します。
ushortLoopCount00 は無限にループします;正の値はその回数で停止します。
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly、FramesOnly、または概要と静止フレームの組み合わせ。

TxtConfig

形式: TXT。デフォルト DPI: 200.

タイププロパティデフォルト動作
DocPaperSizePaperSizeA4出力用紙サイズ。
Encoding?FileEncodingnullnull は UTF-8 を使用します。
stringFontInformation""テキストレンダリング用のフォント情報。

プレーンテキストでよりリッチなページレイアウト動作が必要な場合は WordConfig を使用してください。

ProjectConfig

形式: MPP、MPP X、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

4 つすべてはデフォルトで 200 DPI で、ネストされた PdfConfig を公開します。

設定形式DefaultRender追加プロパティ/動作
HtmlConfigHTML, HTMtrueネイティブレンダリング;テキストベースの PDF 検索パスには false を使用してください。
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 = ["/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
    }
];

拡張子別の選択

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 // フォーマットのデフォルト設定にフォールバック
};

このページは役に立ちましたか?