Макет сторінки зображення
Макет сторінки зображення
Ця сторінка документує клас конфігурації MultiPageLayout та його пов’язані перерахування рендерингу зображень, і пояснює, чому вони не мають функціонального шляху збереження у цьому випуску.
Aspose.Words FOSS для .NET включає невеликий набір класів моделей, що описують, як кілька сторінок документа будуть розташовані при рендерингу в один вихідний образ-на-основі — MultiPageLayout та його допоміжні перерахування. Ця версія не включає сам рушій розташування сторінок та рендерингу (див. Функції та можливості і огляд продукту), тому ці типи існують у публічному API шарі як конфігураційні примітиви без шляху збереження, який споживає їх у цій збірці.
MultiPageLayout
MultiPageLayout — це запечатаний клас, у якого статичні фабричні методи створюють різні багатосторінкові розташування: Vertical(verticalGap) розташовує сторінки вертикально зверху вниз з заданим відступом між ними; Horizontal(horizontalGap) розміщує сторінки поруч, зліва направо; Grid(columns, horizontalGap, verticalGap) розташовує сторінки зліва направо, зверху вниз у сітці з вказаною кількістю колонок; TiffFrames() зберігає кожну сторінку як окремий кадр замість об’єднання їх в одне зображення; і SinglePage() рендерить лише одну сторінку. Після створення екземпляр MultiPageLayout надає BackColor та BorderColor (обидва Color) і BorderWidth (float) для стилізації комбінованого виходу.
Пов’язані перерахування рендерингу
Три додаткових перерахування описують те саме доменне поле «сторінки документа як зображення»: ImageColorMode (None, Grayscale, BlackAndWhite) керує кольоровим режимом згенерованих зображень сторінок; ImagePixelFormat перераховує доступні піксельні формати для згенерованих зображень сторінок (наприклад, Format24BppRgb та Format32BppArgb); і ImageBinarizationMethod (Threshold, FloydSteinbergDithering) визначає, як зображення перетворюється у чорно-біле. Як і MultiPageLayout, вони визначені в API surface, але наразі не пов’язані з класом параметрів збереження у цьому випуску — ця FOSS збірка не включає експорт у форматах зображення, PDF чи XPS.
Поради та найкращі практики
- Ставте
MultiPageLayoutта його пов’язані перерахування лише як довідкові у цьому випуску — у публічній поверхні API немає шляхуSave(), який споживає екземплярMultiPageLayoutдля фактичного створення зображення. - Якщо ваш робочий процес потребує рендерингу 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
Чи можу я використати 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) |