کار با Shapes
در این مبحث نحوه کار برنامه‌نویسی با اشکال با استفاده از Aspose.Words بحث می‌شود.
اشکال در Aspose.Words یک شی را در لایه ترسیم نشان می دهند، مانند AutoShape، textbox، freeform، Object OLE، کنترل ActiveX یا تصویر. یک سند Word می تواند شامل یک یا چند شکل مختلف باشد. اشکال سند توسط کلاس Shape نشان داده می شود.
درج اشکال با استفاده از Document Builder
می توانید شکل درون خطی با نوع و اندازه مشخص و شکل شناور آزاد با موقعیت، اندازه و نوع بسته بندی متن مشخص شده را با استفاده از روش insert_shape در سند وارد کنید. روش insert_shape اجازه می دهد تا شکل DML را در مدل سند وارد کنید. سند باید در قالبی ذخیره شود که از اشکال DML پشتیبانی می کند، در غیر این صورت، این گره ها در حین ذخیره سند به شکل VML تبدیل می شوند.
مثال کد زیر نحوه درج این نوع اشکال را در سند نشان می دهد:
تنظیم نسبت تصویر قفل شده است
با استفاده از Aspose.Words، می توانید تعیین کنید که آیا نسبت ابعاد شکل از طریق ویژگی aspect_ratio_locked قفل شده است یا خیر.
مثال کد زیر نحوه کار با ویژگی AspectRatioLocked را نشان می دهد:
تنظیم طرح بندی شکل در سلول
همچنین می توانید با استفاده از ویژگی is_layout_in_cell تعیین کنید که شکل در داخل جدول نمایش داده شود یا خارج از آن.
مثال کد زیر نحوه کار با ویژگی IsLayoutInCell را نشان می دهد:
یک مستطیل گوشه برش ایجاد کنید
می توانید با استفاده از Aspose.Words یک مستطیل گوشه بریده ایجاد کنید. انواع شکل ها SINGLE_CORNER_SNIPPED، TOP_CORNERS_SNIPPED، DIAGONAL_CORNERS_SNIPPED، TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPED، SINGLE_CORNER_ROUNDED، TOP_CORNERS_ROUNDED و DIAGONAL_CORNERS_ROUNDED هستند.
شکل DML با استفاده از روش insert_shape با این انواع شکل ایجاد می شود. این انواع را نمی توان برای ایجاد اشکال VML استفاده کرد. تلاش برای ایجاد شکل با استفاده از سازنده عمومی کلاس Shape، استثنای “NotSupportedException” را ایجاد می کند.
مثال کد زیر نحوه درج این نوع اشکال را در سند نشان می دهد:
امتیاز مرزهای شکل واقعی را دریافت کنید
با استفاده از Aspose.Words API، می توانید مکان و اندازه شکل حاوی بلوک را در نقاط، نسبت به لنگر بالاترین شکل بدست آورید. برای این کار از ویژگی bounds_in_points استفاده کنید.
مثال کد زیر نحوه کار با ویژگی BoundsInPoints را نشان می دهد:
Vertical Anchor را مشخص کنید
با استفاده از ویژگی vertical_anchor می‌توانید تراز عمودی متن را در یک شکل مشخص کنید.
مثال کد زیر نحوه کار با ویژگی VerticalAnchor را نشان می دهد:
تشخیص شکل SmartArt
Aspose.Words همچنین اجازه می دهد تا تشخیص دهد که آیا Shape دارای یک شی SmartArt است یا خیر. برای این کار از ویژگی دارایی_smart_art استفاده کنید.
مثال کد زیر نحوه کار با ویژگی HasSmartArt را نشان می دهد:
درج قانون افقی در سند
با استفاده از روش insert_horizontal_rule می توانید شکل قاعده افقی را در سند وارد کنید.
مثال کد زیر نحوه انجام این کار را نشان می دهد:
Aspose.Words API ویژگی horizontal_rule_format را برای دسترسی به خصوصیات شکل قاعده افقی فراهم می کند. کلاس HorizontalRuleFormat ویژگی های اساسی مانند height، color، no_shade و غیره را برای قالب بندی یک قانون افقی نشان می دهد.
مثال کد زیر نحوه تنظیم HorizontalRuleFormat را نشان می دهد:
شی OLE را به عنوان نماد درج کنید
Aspose.Words API تابع Shape.insert_ole_object_as_icon را برای درج یک شی OLE تعبیه شده یا پیوند شده به عنوان نماد در سند فراهم می کند. این تابع اجازه می دهد تا فایل نماد و عنوان را مشخص کنید. نوع شی OLE باید با استفاده از پسوند فایل شناسایی شود.
مثال کد زیر نحوه تنظیم درج شی OLE به عنوان یک نماد در سند را نشان می دهد:
اشکال را با Math XML به عنوان Shapes به DOM وارد کنید
می توانید از ویژگی convert_shape_to_office_math برای تبدیل اشکال با EquationXML به آبجکت های Office Math استفاده کنید. مقدار پیش‌فرض این ویژگی با رفتار MS Word مطابقت دارد، یعنی اشکال با معادله XML به اشیاء ریاضی Office تبدیل نمی‌شوند.
مثال کد زیر نحوه تبدیل اشکال به اشیاء ریاضی آفیس را نشان می دهد: