چیدمان صفحه تصویر
چیدمان صفحه تصویر
این صفحه کلاس پیکربندی MultiPageLayout و شمارشهای مرتبط با رندر تصویر آن را مستند میکند و توضیح میدهد چرا در این نسخه مسیر ذخیرهسازی عملکردی ندارند.
Aspose.Words FOSS برای .NET شامل مجموعهای کوچک از کلاسهای مدل برای توصیف چگونگی چیدمان چندین صفحه سند هنگام رندر شدن به یک خروجی مبتنی بر تصویر — MultiPageLayout و شمارشهای پشتیبان آن. این نسخه شامل موتور صفحهبندی و رندرینگ خود نیست (به ویژگیها و قابلیتها و نمای کلی محصول), بنابراین این انواع در سطح عمومی API به عنوان اولیههای پیکربندی وجود دارند بدون مسیر ذخیرهسازی که آنها را در این ساخت مصرف کند.
MultiPageLayout
MultiPageLayout یک کلاس sealed است که هر یک از متدهای کارخانهای ایستاتیک آن، یک چیدمان چند-صفحهای متفاوت را میسازند: 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 تعریف شدهاند اما در حال حاضر به کلاس گزینههای ذخیرهسازی در این نسخه متصل نشدهاند — این ساخت FOSS شامل خروجی تصویر، PDF یا XPS نیست.
نکات و بهترین روشها
- در این نسخه،
MultiPageLayoutو فهرستهای مرتبط با آن را فقط به عنوان مرجع در نظر بگیرید — مسیرSave()در سطح عمومی API که یک نمونه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) |