画像ページレイアウト
画像ページレイアウト
このページでは、MultiPageLayout 設定クラスとそれに関連する画像レンダリング列挙型を文書化し、なぜこのエディションでは機能的な保存パスが存在しないのかを説明します。
Aspose.Words .NET 用の FOSS には、複数の文書ページを単一の画像ベース出力にレンダリングした際の配置方法を記述するための小さなモデルクラスのセットが含まれています — MultiPageLayout およびそれに付随する列挙型です。このエディションにはページレイアウトおよびレンダリングエンジン自体は含まれていません(参照 機能と特長 および 製品概要), したがってこれらの型はパブリックな API サーフェス上に設定プリミティブとして存在しますが、このビルドではそれらを消費する保存パスはありません。
MultiPageLayout
MultiPageLayout はシールドクラスで、静的ファクトリーメソッドがそれぞれ異なる複数ページの配置を構築します: Vertical(verticalGap) はページを上下にスタックし、間に指定されたギャップを設けます; Horizontal(horizontalGap) はページを左から右へ横並びに配置します; Grid(columns, horizontalGap, verticalGap) は指定された列数で左から右、上から下へグリッド状にページを配置します; TiffFrames() はページを1つの画像に結合せず、個別のフレームとして保持します; そして SinglePage() は単一ページのみをレンダリングします。構築後、MultiPageLayout インスタンスは結合された出力のスタイリングのために BackColor と BorderColor(いずれも Color)および BorderWidth(float)を公開します。
関連するレンダリング列挙型
追加の 3 つの列挙型が同じ「ドキュメントページを画像として扱う」領域を説明します: ImageColorMode(None, Grayscale, BlackAndWhite)は生成されたページ画像のカラーモードを制御します; ImagePixelFormat は生成されたページ画像で利用可能なピクセルフォーマットを列挙します(例: Format24BppRgb や Format32BppArgb); そして ImageBinarizationMethod(Threshold, FloydSteinbergDithering)は画像を白黒に変換する方法を指定します。MultiPageLayout と同様に、これらは API サーフェスで定義されていますが、現在このエディションの保存オプションクラスには接続されていません — この FOSS ビルドには画像、PDF、または XPS のエクスポートは含まれていません。
ヒントとベストプラクティス
- このエディションでは、
MultiPageLayoutとそれに関連する列挙は参照専用として扱ってください — 公開された API 表面には、MultiPageLayoutインスタンスを消費して実際に画像を生成するSave()パスウェイは存在しません。 - ワークフローで Word 文書を TIFF、PNG、JPEG、またはその他の画像形式にレンダリングする必要がある場合は、商用の Aspose.Words for .NET、これらのタイプが設計されたフルレンダリングエンジンを含みます。
- この画像用ページレイアウト領域と、文書内部に画像を埋め込むこと(
Shape/ImageDataAPI)を混同しないでください — それは別の、通常の文書コンテンツ機能であり、ページレンダリングではありません。
一般的な問題
| 問題 | 原因 | 修正 |
|---|---|---|
メソッドは MultiPageLayout インスタンスを受け付けません | このエディションには image/PDF/XPS レンダリングエンジンが含まれていません | ページレンダリングと画像エクスポートには、商用 Aspose.Words(.NET 用)を使用してください |
Document.Save() を画像拡張子に変換するのに失敗しました | このエディションでは、画像ベースの保存形式に必要な image/PDF/XPS レンダリングエンジンを除外しています | 代わりに DOCX、DOCM、DOTX、DOTM、Flat OPC、Markdown、またはプレーンテキストに保存します |
FAQ
マルチページ TIFF として文書をエクスポートするために MultiPageLayout を使用できますか?
このエディションには含まれていません。MultiPageLayout とそのサポート列挙 (ImageColorMode, ImagePixelFormat, ImageBinarizationMethod) は API 表面に存在しますが、それらを消費する画像レンダリング保存パイプラインはこの FOSS ビルドの一部ではありません。
このクラスはここで機能しないのであれば、なぜ存在するのですか?
Aspose.Words .NET 用のFOSSは、書き直しではなく、無料コアに縮小された本物のAspose.Wordsコードベースです — 削除されたレンダリングエンジンに結びついた一部のモデル層クラスは、現在サポートされている保存パスがそれらを使用していなくても、ライブラリにコンパイルされたまま残っています。
文書内に画像を埋め込むことも除外対象ですか?
いいえ — Shape と ImageData を使用して文書のコンテンツ内に画像を挿入・フォーマットすることは、通常のサポートされた文書編集機能です。ページ全体を画像形式にレンダリングすることだけが除外されます。
API Reference の概要
| クラス / 列挙型 | 説明 |
|---|---|
MultiPageLayout | 複数ページを1つの画像ベース出力に結合する方法を設定します(Vertical、Horizontal、Grid、TiffFrames、SinglePage) |
ImageColorMode | 生成されたページ画像のカラーモード(None、Grayscale、BlackAndWhite) |
ImagePixelFormat | 生成されたページ画像のピクセル形式オプション |
ImageBinarizationMethod | 白黒変換方法 (Threshold, FloydSteinbergDithering) |