Макет страницы изображения

Макет страницы изображения

Макет страниц изображения

Эта страница документирует класс конфигурации MultiPageLayout и связанные с ним перечисления рендеринга изображений, а также объясняет, почему у них нет функционального пути сохранения в этом издании.

Aspose.Words FOSS для .NET включает небольшой набор классов модели, описывающих, как несколько страниц документа будут расположены при рендеринге в единый вывод на основе изображения — MultiPageLayout и его поддерживающие перечисления. Это издание не включает сам движок макета страниц и рендеринга (см. Функции и возможности и обзор продукта), поэтому эти типы существуют в публичной поверхности API как примитивы конфигурации без пути сохранения, который потреблял бы их в этой сборке.


MultiPageLayout

MultiPageLayout — это sealed class, чьи static factory methods каждый создают различную многостраничную компоновку: Vertical(verticalGap) размещает страницы сверху вниз с заданным промежутком между ними; Horizontal(horizontalGap) располагает страницы рядом, слева направо; Grid(columns, horizontalGap, verticalGap) упорядочивает страницы слева направо, сверху вниз в сетке с указанным количеством столбцов; TiffFrames() сохраняет каждую страницу как отдельный кадр вместо объединения их в одно изображение; и SinglePage() рендерит только одну страницу. После создания MultiPageLayout instance предоставляет BackColor и BorderColor (оба Color) и BorderWidth (float) для стилизации объединённого вывода.


Связанные перечисления рендеринга

Три дополнительных перечисления описывают тот же домен «страницы документа как изображения»: ImageColorMode (None, Grayscale, BlackAndWhite) управляет цветовым режимом генерируемых изображений страниц; ImagePixelFormat перечисляет доступные форматы пикселей для генерируемых изображений страниц (например, Format24BppRgb и Format32BppArgb); и ImageBinarizationMethod (Threshold, FloydSteinbergDithering) определяет, как изображение преобразуется в чёрно-белое. Как и MultiPageLayout, они определены в поверхности API, но в текущем издании не подключены к классу параметров сохранения — эта сборка FOSS не включает экспорт в изображение, PDF или XPS.


Советы и лучшие практики

  • Считайте MultiPageLayout и связанные с ним перечисления только справочными в этом издании — в публичной поверхности API нет пути Save(), который потреблял бы экземпляр MultiPageLayout для фактического создания изображения.
  • Если ваш рабочий процесс требует рендеринга документов Word в TIFF, PNG, JPEG или другие форматы изображений, используйте коммерческий Aspose.Words для .NET, который включает полностью движок рендеринга, для которого предназначены эти типы.
  • Не путайте эту область макета страницы для изображений с встраиванием картинок в документ ( Shape / ImageData API) — это отдельная, обычная функция содержимого документа, а не рендеринг страницы.

Общие проблемы

ПроблемаПричинаИсправление
Ни один метод не принимает экземпляр MultiPageLayoutЭто издание не включает движок рендеринга image/PDF/XPSИспользуйте коммерческий Aspose.Words для .NET для рендеринга страниц и экспорта изображений
Преобразование Document.Save() в расширение изображения не удалосьЭто издание исключает движок рендеринга image/PDF/XPS, необходимый для форматов сохранения на основе изображенийСохраните вместо этого в DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown или обычный текст

FAQ

Могу ли я использовать MultiPageLayout для экспорта моего документа в многостраничный TIFF?

В этом издании нет. MultiPageLayout и поддерживающие его перечисления (ImageColorMode, ImagePixelFormat, ImageBinarizationMethod) присутствуют в поверхности API, но конвейер сохранения с рендерингом изображений, который их использовал бы, не входит в эту сборку FOSS.

Зачем существует этот класс, если он здесь не функционирует?

Aspose.Words FOSS для .NET — это подлинный код Aspose.Words, сокращённый до свободного ядра, а не переписанный вариант — некоторые классы уровня модели, связанные с удалённым движком рендеринга, остаются скомпилированными в библиотеке, хотя ни один поддерживаемый путь сохранения сейчас их не использует.

Является ли встраивание изображения в документ также исключено?

Нет — вставка и форматирование изображений в содержимое документа (через Shape и ImageData) является обычной поддерживаемой функцией редактирования документов. Исключается только рендеринг целых страниц в графический формат.


API Reference Сводка

Класс / ПеречислениеОписание:
MultiPageLayoutНастраивает, как несколько страниц объединяются в один вывод на основе изображений (Vertical, Horizontal, Grid, TiffFrames, SinglePage)
ImageColorModeЦветовой режим для сгенерированных изображений страниц (None, Grayscale, BlackAndWhite)
ImagePixelFormatПараметры формата пикселей для сгенерированных изображений страниц
ImageBinarizationMethodМетод преобразования в черно-белый (Threshold, FloydSteinbergDithering)
 Русский