Макет страницы изображения
Макет страниц изображения
Эта страница документирует класс конфигурации 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/ImageDataAPI) — это отдельная, обычная функция содержимого документа, а не рендеринг страницы.
Общие проблемы
| Проблема | Причина | Исправление |
|---|---|---|
Ни один метод не принимает экземпляр 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) |