HotXLS ドキュメント

高度なレンダリングとエクスポート

PDF、SVG、ビットマップ、メタファイル、プレビュー、および印刷の各パスは、1 つのページ分割モデルとバックエンドに依存しないジオメトリを共有しつつ、フォーマット固有のエンコーダーを保持します

カスタム グラフィックス バックエンド

TXLSGraphicsTextAlign は、 TXLSGraphicsBackendのテキスト配置を左、中央、右で定義します。スタイル付きの描画呼び出しは、残りの共通 enum を受け取ります。フォント スタイル(TXLSGraphicsFontStyles)、線端の形状(TXLSGraphicsLineCap)、破線パターン(TXLSGraphicsLineDash)、縦方向のテキスト配置(TXLSGraphicsTextVAlign)です

Page lifecycleBeginPage と EndPage
PrimitivesFillRect、 StrokeRect、 DrawLine、 DrawStyledLine、 DrawEllipse、 DrawPath、 DrawText、 DrawStyledText、 DrawCellText、および DrawImage
Pagination entry pointTXLSPaginationModel.RenderPageToBackend は、任意のバックエンド実装に 1 つの論理ページを送信します

実装は、ワークブックのレイアウト処理を繰り返すことなく、ポイント単位の座標、解決済みのテキストおよび画像エフェクト、クリッピング、ページローカルの描画配置を受け取ります。論理ページ上の各描画は TXLSPageDrawingPlacement レコードとして届き、その Kind (TXLSPageDrawingKind: xpdkImage、 xpdkChart、 xpdkTextBox、 xpdkShape、 xpdkControl)が、バックエンドに何を描画しているのかを伝えます。ワークシート背景のタイルは、デコード済みの TXLSSheetBackgroundRenderData

操作所有のレンダリング ジオメトリ

TXLSPaginationModel.RenderBackend は、次の Build 呼び出しで取得されるバックエンド識別子を選択し、 RenderGeometry はその結果としての不変のキャリブレーション、ワークブック生成、バックエンド、および上限付きメトリックキャッシュの状態を公開します。アクティブなレンダリングセッションは TXLSRenderSession ハンドルとして受け渡され、カラーポリシーは TXLSRenderColorMode (xlsrcColor または xlsrcMonochrome)で指定します

PDF モデルは xlsrgbPdf、SVG は xlsrgbSvg、ページ画像は xlsrgbBitmap、印刷および印刷プレビューのモデルは xlsrgbPrintPreview、 TXLSWorkbookViewer は xlsrgbViewerを使用します。SVG、画像、印刷、ビューアーの各コンポーネントの PaginationModel は、所有権を移さずに、診断用のアクティブなモデルを公開します

クラシックおよび XLSX の HTML エントリ ポイントは xlsrgbHtmlを取得します。 TXLSHTMLExport.RenderGeometry は最新のクラシックのスナップショットを公開し、 TXLSXHtmlExportSession.RenderGeometry は増分エクスポート内のすべてのシートにわたって保持されるスナップショットを公開します

HTML の列幅の出力では、固定の CSS ピクセル長を出力する前に、ワークブックの文字幅モデルを Normal フォントの最大桁幅と設定された画面スケーリングを通じて変換します。ポイントとピクセルの変換には、同じ取得済みの計測 DPI を使用します

各操作は、後からワークブックが変更されても取得済みのキャリブレーションを保持し、レンダリングがワークシートの行の高さや列の幅を書き込むことはありません。ページ分割は TXLSLogicalPage オブジェクトからページを構築します。その描画、用紙方向(TXLSPageOrientation: xpoPortrait または xpoLandscape)、コメントの配置(TXLSPrintComments: xpcNone または xpcAtEnd)は、解決済みのページ設定から取得されます

論理ページは、バックエンドやコールバックが必要とするすべてを公開します。識別情報(DocumentPageNumber、 SheetPageNumber、 SheetName、所有する ClassicWorksheet または XlsxWorksheet)、ジオメトリ(PageWidth、 PageHeight、 Scale、および LeftMargin、 RightMargin、 TopMargin、 BottomMargin、 HeaderMargin、 FooterMargin の各値)、印刷タイトル付きのデータ矩形(DataFirstRow、 DataLastRow、 DataFirstCol、 DataLastColとRepeatFirstRow、 RepeatLastRow、 RepeatFirstCol、 RepeatLastCol)、背景の配置(BackgroundOffsetX、 BackgroundOffsetY)、グリッドライン出力(PrintGridlines、 GridlineColor)、ヘッダーとフッターの 6 つの帯テキスト(LeftHeader、 CenterHeader、 RightHeader、 LeftFooter、 CenterFooter、 RightFooter)、そしてページの行・列スケルトン(RowCount と Rows を伴う RowEdges、 ColumnCount と Columns を伴う ColumnEdges)に加えて、その描画リスト(DrawingCount と Drawings)です。 ExpandHeaderFooter はページに対してヘッダーとフッターの書式コードを解決し、 ExpandHeaderFooterStyled はさらに先頭のポイント サイズと色を報告するため、カスタムペインターでも Excel 本来のヘッダー描画に合わせられます

ネイティブ ページネーションにおける結合セル

TXLSPaginationModel.RenderPageToBackend は、結合範囲を元のアンカーに解決し、ページ断片ごとに 1 つの可視矩形を描画します。覆われたセルは重複したテキストや内部グリッド線を出力しません

XLSX の断片はアンカーの塗りつぶし、配置、折り返し、フォント、条件付き書式の評価を共有しますが、明示的な外側の罫線セグメントは可視のまま、結合内部の罫線は抑制されます。クラシックの断片は、既存のクラシック テキスト ペインターを通じてアンカーのテキストと単色塗りつぶしを共有します

印刷範囲や改ページは結合範囲をクリップすることがあり、アンカーが印刷範囲の外側にあっても、すべての可視断片は元のアンカーを使用します。非表示の行と列は寸法ゼロとして寄与し、繰り返される印刷タイトルの断片も同じアンカー ポリシーに従います

結合は、範囲を 1 ページに強制したり、印刷範囲を拡大したり、保存された行の高さや列の幅を変更したりしません。ページネーションは既存のページ設定を保持し、各断片を論理ページにクリップします

ワークシート背景のレンダリング

ワークブック ビューアーは、有効なクラシックおよび XLSX のワークシート背景を、塗りつぶされていないセルの背後に繰り返しタイルとして表示します。明示的なセル塗りつぶしと条件付き書式によるセル塗りつぶしは、背景より手前に表示されます

TXLSPaginationModel、 TXLSSvgExport、 TXLSPageImageExporter、 TXLSPrintDocument、 TXLSPDFExport、 TXLSHTMLExport、 TXLSXHtmlExportOptions、および TXLSWorkbookViewer は ExportSheetBackgroundImagesを公開します。印刷、プレビュー、メタファイル、PDF、SVG、ビットマップ、HTML 出力でのデフォルトは False です。ワークシートはペイロードを TXLSSheetBackgroundFormat の画像形式で保存し、デコードされたバイト列は、生成、DPI、カラーモードをキーとする TXLSSheetBackgroundResource として受け渡されます

有効化されたページ分割出力では、タイル配置のフェーズがページ境界をまたいでワークシート座標に固定され、レンダリングセッションごとに、ワークシート、リソース生成、バックエンド、DPI、カラーモードの組み合わせにつき 1 枚のデコード済み画像が保持されます。 BackgroundDecodeCount は診断用にデコード総数を公開し、壊れたペイロードはワークブック診断とともにスキップされます。アクティブな TXLSRenderSession がこの共有キャッシュを自前で管理します。 AcquireBackground はワークシートのタイル状の TXLSSheetBackgroundRenderData を取得し(デコードは 1 回だけ)、 DrawTiledBackground がクリップされたページ領域全体にそれを描画し、 DecodeCount がそれまでにデコードしたペイロード数を報告します

ワークブックオブジェクトの表示ポリシー

ObjectDisplayMode は、クラシック XLS と XLSX の両方のワークブックに対して xlsodmShowAll、 xlsodmShowPlaceholders、 xlsodmHideAll のいずれかを選択します。ビューアーは 3 つの状態すべてを扱え、プレースホルダーモードでは低コストな種別・名前・テキスト・代替テキストのボックスを使用します

PDF、SVG、ビットマップ、物理印刷、XLSX HTML の各エクスポーターは、デフォルトではプレースホルダーモードをオブジェクト全体の出力として扱います。画像のデコードやグラフシーンの構築なしにボックス表示が必要な場合は、対応するエクスポーターまたは HTML オプションに ExportObjectPlaceholders を設定します

xlsodmHideAll はより前段のグローバルゲートで、描画の収集、オブジェクトによる範囲拡張、ヒットテスト、メディアのレンダリングを防ぎます。ワークシート背景、条件付き書式のアイコン、ヘッダーやフッターの画像、セル、およびエクスポーター固有の印刷オブジェクトフィルターは、独立したままです

グラフ ソース データの更新

XLSX グラフのシリアライズと共有グラフ レンダリングは、ローカルの系列キャッシュを現在のワークブックの世代に対して解決するため、ソース セルの編集、再計算、表示状態の変更が、出力前に値、カテゴリ、バブル サイズ、範囲リンクの系列名を更新します

通常のソース範囲は、ローカル A1 参照の 1 行または 1 列でなければなりません。引用符付きのワークシート名はサポートされ、修飾されない範囲はグラフを所有するワークシートに対して解決されます。階層化されたカテゴリ レベルは、独自の矩形範囲リゾルバーを保持します

カテゴリ テキストは書式設定されたセル テキストを使用し、数値キャッシュは空白や非数値テキストに対して空のポイント スロットを保持し、エラー セルは表示されているエラー リテラルを保持し、日付はワークブックの 1900 または 1904 シリアル システムを使用します。PlotVisibleOnly が、非表示のソース行と列を省略するかどうかを決定します

インポートされた、または手動で設定されたキャッシュは、ローカル ソースが一度も実体化されていない場合は保持され、ローカル セルから管理されるキャッシュは削除後に古いポイントをクリアします。TXLSXChartSeries.RefreshDataCaches は、空のソース範囲を含めて、解決可能なローカル ソースを明示的に更新します

外部ワークブック参照とサポートされない参照式は、保存されたキャッシュを保持します。キャッシュの更新は、外部ファイルを開いたりネットワーク要求を実行したりしません

カレンダー対応のグラフ日付軸

TXLSXChartSeries.ResolveDataCaches は、現在の世代に対してサポート対象のローカル系列ソースを解決し、RefreshDataCaches は、空のソースにセル履歴がない場合でも明示的な更新を要求します

カテゴリ軸に xlsxAxisDate を使用する XLSX グラフは、すべての有効なカテゴリをワークブックの 1900 または 1904 シリアル日付システムにマッピングし、等間隔のポイント スロットを割り当てる代わりに、まばらな日付間の実際の距離を保持します

BaseTimeUnit が日・月・年のいずれかでの正規化を制御し、 MajorUnit、 MinorUnit、 MajorTimeUnit、 MinorTimeUnit がカレンダー単位で目盛を進めます。そのため、月の長さが異なっていても閏年でも、月や年の間隔は揃ったままになります

同じ上限付き目盛コレクションが、ページ分割ベースの PDF、SVG、ビットマップ、プレビュー、印刷、ビューアー出力に対して、座標、ラベル、目盛、要求されたグリッドラインを供給します。一方、XLSX HTML はインラインのグラフ SVG に、この共通のカレンダー計算を使用します

スタンドアロン PDF ライター

TXLSPDFWriter は、請求書、チケット、ラベル、オーバーレイ帳票のようにワークブック由来ではない PDF ドキュメントを作成します。 BeginDoc がポイント精度のページボックスを設定し、 NewPage が現在のページを確定し、 SaveToStream または SaveToFile がドキュメントを完了させます

描画メソッドは左下原点の PDF ポイントと、 $00BBGGRR または $AABBGGRR 形式のライブラリ色を使用します。利用可能なプリミティブは、塗りつぶしとストロークの矩形、線、楕円、正確な幅計測が可能なスタイル付きテキスト、アフィン変換、矩形クリッピング、グラフィックス状態の明示的な保存と復元のための FillRectangle、 StrokeRectangle、 ClipRectangle、 MeasureText、 SaveGraphicsState、 RestoreGraphicsState をカバーし、 PageWidth と PageHeight は現在のページボックスをポイント単位で報告します

SVG エクスポート

TXLSSvgExport は、クラシックおよび XLSX の範囲、ワークシート、ワークブック、準備済みの論理ページ用に 7 つの SaveAsSVG オーバーロードを提供し、サポートされている場合は名前付きオブジェクト出力も提供します

UseWorksheetPageSetup、 Orientation、および Margin は、PDF やプレビュー出力と同じページ設定の決定を使用します

TXLSSvgExport.PrintComments (型は TXLSPrintComments)は、ページ分割された SVG 出力でセル コメントをどのように出力するかを選択します。 xpcAtEndを設定すると、シートの最終ページがデータ領域の下にコメント一覧(セル アドレス、作成者、テキスト)を追記し、 xpcNone ではコメントを出力しません

ExportPages は完全な SVG ドキュメントを 1 回に 1 つずつ OnPage経由で送り、確定済みのページ数を ExportedPageCountで報告します。コールバックがキャンセルすると、後続のページを生成する前に停止します。 IdPrefix は、クリップ パス、フィルター、パターン、共有リソースのための決定論的なドキュメントおよびページの名前空間を生成します

HyperlinkMode (型は TXLSSvgHyperlinkMode)を xshmSafe にすると、視覚コンテンツの後にクリップされた透明なヒット領域を追加します。許可される外部スキームは HTTP、HTTPS、メール、FTP、相対リンクで、アクティブ、ローカル、UNC、制御文字を含むターゲットは除外されます。 LinksInNewWindow は noopener noreferrer 保護を追加し、ScreenTip は SVG タイトルになります

増分 PNG、JPEG、および複数ページ TIFF 出力

TXLSPageImageFormat は PNG または JPEG 出力を選択し、 TXLSPageImageExporter は、完了した各ビットマップを即座に解放しながら、1 つのページ分割セッションを維持します

Session6 つの BeginExport オーバーロードは、クラシックまたは XLSX の範囲、ワークシート、ワークブックを受け入れます。 ExportNext は 1 ページを書き込み、 EndExport はセッションを解放します
Multipage TIFFExportAllAsTiff は、選択した論理ページを 1 つの LZW 圧縮 TIFF としてストリームまたはファイルに書き込みます。進捗報告、キャンセル、およびアトミックな出力先のセマンティクスは保持されます
Page setupUseWorksheetPageSetup、 Orientation、 Margin、 DefaultRowHeight、 PaperWidthOverride、および PaperHeightOverride
Raster outputScale、 ImageFormat、および JpegQuality。 ExportObjectAsPNG は、単一の描画オブジェクトを所有権付きの PNG にレンダリングします
Compact rangesExportRange は、クラシックまたは XLSX の範囲を、用紙、余白、ヘッダー、フッター、印刷タイトル、改ページなしの 1 枚のタイトなラスターとしてレンダリングします
Canvas eventsBeforeRenderPage は背景クリアの後に実行され、 AfterRenderPage はワークブックの描画後、エンコード前に実行されます。PNG、JPEG、TIFF の各フレームは同じイベント経路を共有します
StateActive、 Aborted、 TotalPageCount、 PageCount、および ExportedPageCount

タグ付き PDF と PDF/A

TXLSPDFExport.TagMode は、ドキュメント、テーブル、行、ヘッダーセル、データセル、情報を持つ画像の構造を自動生成します。ページ ローカルな密な marked-content 識別子、正確な親ツリー マッピング、結合セルのスパン、アーティファクトの分離が含まれます。印刷タイトル行とテーブルのヘッダー行はセマンティックなヘッダーセルになり、空でない AltText を持つ XLSX 画像は Unicode 代替テキストを持つ独立した Figure 要素になり、代替テキストのない画像は装飾アーティファクトのままです

同じ画像ペイロードが 1 つの PDF XObject を共有していても、可視の情報画像インスタンスごとに個別の Figure 要素と marked-content 識別子が割り当てられます。 AltTextTitle は欠落した代替テキストの代用にはならず、グラフはアーティファクトのままです。この構造化サポートは、完全な PDF/UA 適合を主張するものではありません

TXLSPDFExport.PDFAProfile は、適合レベル a または b の PDF/A-1、PDF/A-2、または PDF/A-3 を選択します。互換性のない暗号化、フォント、添付ファイル、透明度、署名、メタデータは、出力ストリームが確定される前に検証されます

TXLSPDFExport.ExportCommentsAsAnnotations は、作成元のセルの四角形に Unicode の作成者とコメントのテキストを配置します。従来のコメント末尾出力は引き続き個別に設定できます

UsePDFA は PDF/A-1b 用の互換性スイッチであり、 UseXRefStream は、選択したプロファイルが許可する場合にクロス リファレンス ストリームを選択します

ページのジオメトリと選択

6 つの CalculatePageCount オーバーロードは、PDF オブジェクトを構築せずに、クラシックおよび XLSX の範囲、ワークシート、またはワークブックを受け入れます

PaperWidth と PaperHeight は用紙寸法をポイント単位で上書きし、 LastPage は 1 始まりの出力区間の終端を指定し、 Orientation (型は TXLSPDFOrientation)は縦または横の出力を選択し、 HidePrintObjects ( TXLSPDFHidePrintObjectのセット: xlsPdfHideHeaders、 xlsPdfHideFooters)は選択したヘッダーまたはフッター帯を抑制し、 PageLayout (型は TXLSPDFPageLayout)はビューアーの初期ページ配置を設定します

PDF ページ モードとオープン アクション

TXLSPDFExport.PageMode (型は TXLSPDFPageMode)は、ドキュメントを開いたときに PDF ビューアーがパネルをどのように配置するかを、 xlsPdfModeDefault、 xlsPdfModeUseOutlines、 xlsPdfModeUseThumbs、 xlsPdfModeFullScreen、 xlsPdfModeUseOC、および xlsPdfModeUseAttachments

OpenAction (型は TXLSPDFOpenAction)は、 xlsPdfOpenNone、 xlsPdfOpenPage、または xlsPdfOpenOutlinesでビューアーの初期動作を選択します。 xlsPdfOpenPageの場合、 OpenActionPage は 1 始まりのターゲット ページ(ページ数にクランプされます)、 OpenActionZoom は初期の倍率です。0 を指定すると、ビューアーの既定のズームまたはフィットが維持されます

共有の適応型ベクター ジオメトリ

XLSBuildEllipticArcCubics は、楕円弧を、呼び出し元が選択した平坦度の上限を再帰的に満たす 3 次 Bezier セグメントへ変換します。PDF、SVG、ビットマップのレンダリングはこの共有ジオメトリを使用するため、大きい弧や扁平率の高い弧には多くのセグメントが割り当てられ、単純な弧には不当な負担がかかりません

XLSDecodeVectorScene は、プラットフォームのメタファイル再生を呼び出さずに、EMF と WMF のヘッダー、レコードのアラインメントとサイズ、宣言された合計値、EOF の正確な位置、リソース上限を検証します。ネイティブのホワイトリストが再生するのは、保存と復元を伴うデバイス コンテキストの状態スタック、ワールド変換と組み合わせたウィンドウとビューポートのマッピング、ストック オブジェクトを含むペン・ブラシ・拡張ペンのオブジェクト テーブル、破線スタイル付きの矩形、楕円、折れ線連鎖、ポリゴン、ポリライン、Bezier 曲線、塗りつぶし・ストローク・その両方のパスを持つパス ブラケット、角丸矩形、正確な弧から Bezier への変換による弧・弦・扇形・角度弧、境界付き RGNDATA 矩形からのリージョンの塗りつぶしと枠線、フォント・色・配置付きの境界付きテキスト実行、Canvas と SVG を通じて PNG として再エンコードされる制限付き stretch-DIB 画像です。エスケープ レコードは拒否し、クリッピングとプライベート レコードは既存の境界付きフォールバックに任せます

PDF アウトラインとページ コールバック

PDF アウトラインは Bookmarks コレクション(型は TXLSPDFBookmarks)に格納されます。 Add と AddForSheet はエントリを追加し、 Delete は 1 つ削除し、 Count と Items はツリーを列挙します。各 TXLSPDFBookmark エントリは、親と子のエントリ(Children)、兄弟チェーン、Unicode タイトル、色(Color)、 PageNumber ターゲット、ワークシート ブックマークのソース SheetName 、太字または斜体のフラグ( TXLSPDFBookmarkStyleのセット: xlsPdfBookmarkBold、 xlsPdfBookmarkItalic)、および展開/折りたたみ状態の子孫をサポートします。自動ワークシート ブックマークは同じ階層モデルを使用し、 AutoSheetBookmarks でその生成を切り替えます

BeforeNewPage で各ページボックスを調整できます。 BeforeGeneratePage と AfterGeneratePage は、公開ページヘルパーの AppendPageContent、 FillPageRectangle、 StrokePageRectangle、および DrawPageText

署名と添付ファイル

TXLSPDFSignature は可視または不可視の署名フィールドを設定し、 CertificationPolicy はオプションで DocMDP 認証署名を作成できます。許可するのは、変更なし、フォーム入力と署名、フォーム入力・署名・注釈のいずれかです。PDF/A-1 はこの PDF 1.5 機能を許可しないため、出力の確定前に拒否されます

TXLSPDFCertificationPolicy は、署名ポリシーを明示的に選択するための xlsPdfApprovalSignature、 xlsPdfCertifyNoChanges、 xlsPdfCertifyFormFillingAndSigning、および xlsPdfCertifyFormFillingSigningAndAnnotations を提供します

A TXLSPDFSignDigestEvent はダイジェストを受け取り、ホスト側で作成された CMS データを返します。そのため、HotXLS が秘密鍵を必要とすることはありません

TXLSPDFExport.Signature は署名設定を添付します。PDF/A-3 プロファイルでは、 AddAttachmentを通じて検証済みの関連ファイルを含められます。これは TXLSPDFAttachmentをキューに入れます。詳細版のオーバーロードは、Unicode の表示名、MIME タイプ、説明、更新時刻、ペイロード、および Source、Data、Alternative、Supplement、Unspecified のいずれかの TXLSPDFAttachmentRelationship 値を受け取ります。 AttachmentCount はキュー内の合計数を報告し、 AttachmentDuplicatePolicy (型は TXLSPDFAttachmentDuplicatePolicy)が同じ名前の扱いを選択します

TXLSPDFSignature.ImageData、 ImageFormat、および ImageFit (型は TXLSPDFSignatureImageFit: contain、cover、stretch)は、バイト レンジが確定される前に、通常の外観用の Form に PNG を配置します。contain、cover、stretch の各モードはドキュメント画像キャッシュを共有し、無効な画像は署名の前に失敗します

The IXLSPDFAttachmentSource のオーバーロードは保存時まで遅延評価され、各ソースを保存ごとに 1 回呼び出します。EmbeddedFile オブジェクトが作成される前には最大 256 MiB までスプールするため、プロバイダーが失敗しても出力先のトランザクションは影響を受けません

最終的な組立では、ドキュメント全体を 1 つの文字列として組み立てる代わりに、オブジェクトを出力先へ順次書き込みます。署名なしのエクスポートは前方参照専用ストリームへ直接ストリーミングされ、各 EmbeddedFile はペイロードの後に出力される間接 /Length オブジェクトでバイト サイズを参照し、プロバイダーのバイト列はスプールから固定チャンクでコピーされます。署名付きのエクスポートは上限付きのドキュメント スプールに組み立てられ、そこに ByteRange と署名内容のパッチ、2 つのカバー範囲にわたる増分 SHA-256、そして 1 回の順方向コピーが施されます

PDF/A-3 出力では、各関連ファイルが EmbeddedFiles の名前ツリーとカタログの AF 配列の両方に書き込まれます。Unicode の UF 名、エスケープされた MIME PDF Name、 AFRelationship、バイト サイズ、オプションの更新日時と説明が付きます。PDF/A-1 と PDF/A-2 は、出力の確定前にキュー済みの添付ファイルを拒否します

ドキュメントのメタデータ

DocumentTitle、 DocumentAuthor、 DocumentSubject、 DocumentKeywords、および DocumentFileName は、PDF の情報およびメタデータ ディクショナリに入力します

フォント フォールバック

TXLSPDFExport.SetFontFallbackChain、 AddFontFallback、および ClearFontFallbackChains は、ソースファミリーおよびスタイル固有のフォールバック階層を設定します。 LoadedFallbackFontCount はキャッシュされたフェイス数を、 FontFallbackSelectionCacheCount は選択ごとにキャッシュされたフォールバック決定の数を公開します。いずれも診断用です

TXLSPDFExport.FontSize は既定のテキスト サイズをポイント単位で設定します。デフォルトは 9 です

フォールバックの選択はグリフのカバレッジを使用し、Unicode マッピング、補助スカラー、書記素クラスター、シェーピング クラスター、スタンドアロン TTC フェイスを保持します

OnGetFontDirectories は、要求されたファミリーとスタイルに対して、セミコロン区切りの 1 つ以上のフォント ディレクトリを返せます。受け入れられたディレクトリは 1 回だけ再帰的に検索され、内部のファミリー/スタイル メタデータでインデックス化され、以降の計測と描画のためにキャッシュされます

フォント埋め込みポリシー

TXLSPDFExport.FontEmbedding (型は TXLSPDFFontEmbedding)は、 xlsPdfFontEmbedAuto、 xlsPdfFontEmbedSubset、 xlsPdfFontEmbedFull、および xlsPdfFontEmbedNoneによる、自動埋め込み、必須サブセット化、完全なフォントプログラム、マップのみの出力のいずれかを選択します。有効なサブセットを生成できない場合、必須サブセット化はアトミックに失敗し、TTC フェイスはスタンドアロン フォントに変換され、PDF/A はマップのみの出力を拒否します

OnFontEmbed は、メトリック、文字マップ、シェーピング、グリフ識別子が解決される前に、Unicode フェイスごとに 1 回発生します。 Handled を設定すると、返されたフォントごとのモードとオプションの置換バイトを受け入れ、false のままにするとドキュメントのポリシーと元のフェイスが保持されます

CFF アウトラインを持つスタンドアロンの OpenType フォントは、 FontFile3 ストリームと OpenType の子孫を伴う CIDFontType0 を通じて埋め込まれます。自動モードと完全モードは完全なプログラムを保持し、必須の CFF サブセット化は有効なサブセットを保持できないため、アトミックに失敗します

OpenType の GPOS または従来の kern データを持つ埋め込みフォントは、単純テキストと複雑テキストの両方で、位置指定されたグリフ アドバンスを使用します。そのため、計測、折り返し、配置、出力されるグリフ位置が同じカーニング結果を共有します

進捗とキャンセル

TXLSPDFExport.OnProgress と OnProgressEx は、開始、ページ、終了の各フェーズを報告します。 Cancel はキャンセルを要求し、 Aborted は部分ストリームを確定せずに最終状態を報告します

関連項目