ارائه اشکال به صورت جداگانه از یک سند

هنگام پردازش اسناد، یک کار مشترک استخراج تمام تصاویر موجود در سند و صادرات آنها به یک مکان خارجی است. این کار با Aspose.Words API ساده می شود که در حال حاضر قابلیت استخراج و ذخیره داده های تصویر را فراهم می کند. با این حال، گاهی اوقات ممکن است بخواهید انواع دیگر محتوای گرافیکی را که توسط نوع دیگری از شیء نقاشی نشان داده شده است، به عنوان مثال، یک جعبه متن حاوی پاراگراف ها، اشکال تیر و یک تصویر کوچک استخراج کنید. هیچ راهی برای ارائه این شی وجود ندارد زیرا ترکیبی از عناصر محتوای فردی است. همچنین ممکن است با موردی مواجه شوید که محتویات آن در یک شی که شبیه یک تصویر است، گروه بندی شده باشد.

Aspose.Words قابلیت استخراج این نوع محتوا را فراهم می کند به همان روشی که می توانید یک تصویر ساده را از شکل به عنوان محتوای ارائه شده استخراج کنید. در این مقاله نحوه استفاده از این قابلیت برای ارائه اشکال مستقل از سند توضیح داده شده است.

انواع شکل در Aspose.Words

تمام محتوای یک لایه نقاشی سند توسط گره Shape یا GroupShape در ماژول Aspose.Words Document Object (DOM) نشان داده شده است. چنین محتویاتی می تواند جعبه های متنی، تصاویر، اشیاء AutoShapes، OLE و غیره باشد. برخی از فیلد ها نیز به عنوان شکل وارد می شوند، به عنوان مثال، فیلد INCLUDEPICTURE.

یک تصویر ساده با یک گره Shape از ShapeType.Image نشان داده می شود. این گره شکل هیچ گره فرزند ندارد اما داده های تصویر موجود در این گره شکل می تواند توسط ویژگی Shape.ImageData دسترسی پیدا کند. از طرف دیگر، یک شکل نیز می تواند از بسیاری از گره های کودک تشکیل شود. به عنوان مثال، یک شکل جعبه متن، که توسط ویژگی ShapeType.TextBox نشان داده می شود، می تواند از بسیاری از گره ها مانند Paragraph و Table تشکیل شود. بیشتر اشکال می توانند شامل گره های سطح بلوک Paragraph و Table باشند. اینها همان گره هایی هستند که در بدن اصلی ظاهر می شوند. شکل ها همیشه بخشی از برخی پاراگراف ها هستند، یا به طور مستقیم در خط یا لنگر زده به Paragraph, اما “شناور” در هر نقطه از صفحه سند.

یک سند همچنین می تواند شامل شکل هایی باشد که با هم گروه بندی شده اند. گروه بندی را می توان در Microsoft Word با انتخاب چندین شی و کلیک بر روی “گروه” در منوی راست کلیک فعال کرد.

در Aspose.Words، این گروه از اشکال توسط گره GroupShape نشان داده می شوند. این ها همچنین می توانند به همان شیوه برای ارائه کل گروه به تصویر فراخوانده شوند.

فرمت DOCX می تواند شامل انواع خاصی از تصاویر مانند نمودارها یا نمودارها باشد. این اشکال همچنین از طریق گره Shape در Aspose.Words نشان داده می شوند که همچنین روش مشابهی برای ارائه آنها به عنوان تصاویر فراهم می کند. از نظر طراحی، یک شکل نمی تواند در کودکی شکل دیگری داشته باشد، مگر اینکه آن شکل یک تصویر باشد (ShapeType.Image). به عنوان مثال، Microsoft Word به شما اجازه نمی دهد یک جعبه متن را در داخل یک جعبه متن دیگر قرار دهید.

انواع شکل های شرح داده شده در بالا یک روش خاص برای ارائه شکل ها از طریق کلاس ShapeRenderer ارائه می دهند. نمونه ای از کلاس ShapeRenderer برای یک Shape یا GroupShape از طریق روش GetShapeRenderer یا با انتقال Shape به سازنده کلاس ShapeRenderer بازیابی می شود. این کلاس دسترسی به اعضای را فراهم می کند که اجازه می دهد یک شکل را به موارد زیر ارائه دهد:

• فایل روی دیسک با استفاده از روش Save overload
• جریان با استفاده از روش Save اضافه بار
• شی گرافیکی با استفاده از روش های RenderToSize و RenderToScale

هنگام ارائه یک Shape، باید بخشی از سلسله مراتب سند باشد. اگر Shape بخشی از درخت سند نباشد، خروجی رندر شده پس از فراخوانی روش های ShapeRenderer خالی خواهد بود.

رندر به فایل یا جریان

روش Save اضافه بار هایی را فراهم می کند که یک شکل را مستقیما به یک فایل یا جریان ارائه می دهد. هر دو overloads یک نمونه از کلاس ImageSaveOptions را قبول می کنند که اجازه می دهد گزینه های تعریف شده برای ارائه شکل را تعریف کند. این روش به همان روش Document.Save کار می کند. حتی اگر این پارامتر مورد نیاز باشد، می توانید یک مقدار null را منتقل کنید، مشخص کنید که هیچ گزینه سفارشی وجود ندارد.

شکل را می توان در هر فرمت تصویر مشخص شده در SaveFormat صادر کرد. به عنوان مثال، تصویر را می توان به عنوان یک تصویر رستر، مانند JPEG با مشخص کردن SaveFormat.Jpeg شمارش، یا به عنوان یک تصویر بردار، مانند EMF با مشخص کردن SaveFormat.Emf ارائه کرد.

مثال کد زیر نشان دهنده ارائه یک شکل به یک تصویر EMF به طور جداگانه از سند و ذخیره به دیسک است:

مثال کد زیر نشان دهنده ارائه یک شکل به یک تصویر JPEG به طور جداگانه از سند و ذخیره به یک جریان است:

کلاس ImageSaveOptions به شما امکان می دهد گزینه های مختلفی را مشخص کنید که نحوه رندر تصویر را کنترل می کند. قابلیت های فوق را می توان به همان شیوه به گره های GroupShape و Shape اعمال کرد.

رندر کردن به یک شی Graphics

رندر مستقیم به یک شیء Graphics به شما اجازه می دهد تنظیمات خود و حالت برای شیء Graphics را تعریف کنید. یک سناریوی رایج شامل ارائه یک شکل به طور مستقیم به یک شیء Graphics است که از یک فرم Windows یا یک نقشه بیت بازیابی شده است. هنگامی که گره Shape رندر می شود، تنظیمات بر ظاهر شکل تأثیر می گذارد. به عنوان مثال، شما می توانید شکل را با استفاده از روش های RotateTransform یا ScaleTransform برای شیء Graphics بچرخانید یا مقیاس بندی کنید.

مثال زیر نشان می دهد که چگونه یک شکل را به یک شیء Graphics جدا از سند ارائه دهید و چرخش را به تصویر ارائه شده اعمال کنید:

به طور مشابه، به روش RenderToSize، روش RenderToSizeبه ارث رسیده از NodeRendererBase برای ایجاد تصاویر کوچک محتوای سند مفید است. اندازه شکل از طریق سازنده مشخص می شود. روش RenderToSize شیء Graphics، مختصات X و Y موقعیت تصویر و اندازه تصویر (عرض و ارتفاع) را که بر روی شیء Graphics کشیده می شود، می پذیرد.

Shape را می توان با استفاده از روش ShapeRenderer.RenderToScale که از کلاس NodeRendererBase به ارث رسیده است به مقیاس خاصی ارائه داد. این شبیه به روش Document.RenderToScale است که همان پارامترهای اصلی را قبول می کند. تفاوت این دو روش این است که با روش ShapeRenderer.RenderToScale، به جای یک اندازه واقعی، شما یک مقدار شناور را انتخاب می کنید که شکل را در طول رندر آن مقیاس بندی می کند. اگر مقدار شناور برابر با 1.0 باشد باعث می شود که شکل در 100 ٪ از اندازه اصلی آن ارائه شود. مقدار شناور 0.5 اندازه تصویر را به نصف کاهش می دهد.

رندر کردن یک تصویر شکل

کلاس Shape اشیاء را در لایه نقاشی نشان می دهد، مانند یک AutoShape، جعبه متن، فرم آزاد، OLE شی، کنترل ActiveX، یا یک تصویر. با استفاده از کلاس Shape، می توانید شکل ها را در یک سند Microsoft Word ایجاد یا تغییر دهید. یک ویژگی مهم یک شکل ShapeType آن است. اشکال انواع مختلف می توانند قابلیت های مختلفی در یک سند Word داشته باشند. به عنوان مثال، فقط تصاویر و اشکال OLE می توانند تصاویر را در داخل خود داشته باشند در حالی که بیشتر اشکال فقط می توانند متن داشته باشند.

مثال زیر نشان می دهد که چگونه یک تصویر شکل را به یک تصویر JPEG جدا از سند ارائه دهید و آن را به دیسک ذخیره کنید:

بازیابی اندازه شکل

کلاس ShapeRenderer همچنین قابلیت بازیابی اندازه شکل در پیکسل را از طریق روش GetSizeInPixels فراهم می کند. این روش دو پارامتر شناور (تک) – مقیاس و DPI را می پذیرد که در محاسبه اندازه شکل هنگام ارائه شکل استفاده می شود. این روش شی Size را باز می گرداند که شامل عرض و ارتفاع اندازه محاسبه شده است. این کار زمانی مفید است که لازم است اندازه شکل رندر شده را از قبل بدانید، به عنوان مثال هنگام ایجاد یک نقشه بیت جدید از خروجی رندر شده.

مثال زیر نشان می دهد که چگونه یک نقشه بیت جدید و شی گرافیکی با عرض و ارتفاع شکل ارائه شده ایجاد کنید:

هنگام استفاده از روش های RenderToSize یا RenderToScale، اندازه تصویر رندر شده نیز در شی SizeF بازگردانده می شود. این را می توان به یک متغیر اختصاص داد و در صورت لزوم استفاده کرد.

ویژگی SizeInPoints اندازه شکل اندازه گیری شده در نقاط را باز می گرداند (به ShapeRenderer مراجعه کنید). نتیجه یک شیء SizeF است که شامل عرض و ارتفاع است.