کار با پاراگراف ها

یک پاراگراف مجموعه ای از کاراکترها است که در یک بلوک منطقی ترکیب شده و با یک کاراکتر خاص به پایان می رسد – a paragraph break. در Aspose.Words، یک پاراگراف توسط کلاس Paragraph نشان داده می شود.

درج یک پاراگراف

برای قرار دادن یک پاراگراف جدید در سند، در واقع، شما باید یک کاراکتر شکستن پاراگراف را در آن قرار دهید. DocumentBuilder.Writeln نه تنها یک رشته متن را در سند قرار می دهد، بلکه یک پاراگراف را نیز اضافه می کند.

قالب بندی فونت فعلی نیز توسط ویژگی Font مشخص شده است و قالب بندی پاراگراف فعلی توسط ویژگی ParagraphFormat تعیین می شود. در بخش بعدی، ما به جزئیات بیشتری در مورد قالب بندی پاراگراف خواهیم پرداخت.

مثال کد زیر نشان می دهد که چگونه یک پاراگراف را در یک سند وارد کنید:

پاراگراف فرمت

قالب بندی پاراگراف فعلی توسط شیء ParagraphFormat که توسط ویژگی ParagraphFormat بازگردانده می شود، نشان داده می شود. این شی ویژگی های مختلف قالب بندی پاراگراف موجود در Microsoft Word را در بر می گیرد. شما می توانید به راحتی قالب بندی یک پاراگراف را به حالت پیش فرض آن تنظیم کنید – سبک عادی، چپ تراز، بدون تورفتگی، بدون فاصله، بدون مرز، بدون سایه-با فراخوانی ClearFormatting.

مثال کد زیر نشان می دهد که چگونه قالب بندی پاراگراف را تنظیم کنید:

سبک پاراگراف را اعمال کنید

برخی از اشیاء قالب بندی مانند فونت یا سبک های پشتیبانی ParagraphFormat. یک سبک داخلی یا تعریف شده توسط کاربر توسط یک شیء Style نشان داده می شود که شامل ویژگی های سبک مربوطه مانند نام، سبک پایه، فونت و قالب بندی پاراگراف سبک و غیره است.

علاوه بر این، یک شی Style ویژگی StyleIdentifier را فراهم می کند که یک شناسه سبک مستقل از محلی را که با یک مقدار StyleIdentifier شمارش نشان داده شده است، باز می گرداند. نکته این است که نام سبک های داخلی در Microsoft Word برای زبان های مختلف محلی شده است. با استفاده از یک شناسه سبک، می توانید سبک صحیح را صرف نظر از زبان سند پیدا کنید. مقادیر شمارش با سبک های داخلی Microsoft Word مانند Normal, Heading 1, Heading 2, و غیره تمام سبک های تعریف شده توسط کاربر به StyleIdentifier.User value اختصاص داده شده است.

مثال کد زیر نشان می دهد که چگونه یک سبک پاراگراف را اعمال کنیم:

برای قرار دادن سبک های مختلف پاراگراف، جداکننده سبک را وارد کنید

جداکننده سبک را می توان با استفاده از میانبر صفحه کلید Ctrl + Alt + Enter به MS Word به پایان یک پاراگراف اضافه کرد. این ویژگی اجازه می دهد تا دو سبک پاراگراف مختلف در یک پاراگراف چاپی منطقی استفاده شود. اگر می خواهید متنی از ابتدای یک عنوان خاص در یک جدول محتویات ظاهر شود اما نمی خواهید کل عنوان در جدول محتویات باشد، می توانید از این ویژگی استفاده کنید.

مثال کد زیر نشان می دهد که چگونه یک جدا کننده سبک را برای جای دادن سبک های مختلف پاراگراف قرار دهید:

مرزها و سایه ها را روی یک پاراگراف اعمال کنید

مرزها در Aspose.Words توسط کلاس BorderCollection نشان داده می شوند – این مجموعه ای از اشیاء Border است که توسط شاخص یا نوع مرز قابل دسترسی است. نوع Border با شمارش BorderType نشان داده می شود. برخی از مقادیر شمارش برای چندین یا تنها یک عنصر سند قابل استفاده است. به عنوان مثال، BorderType.Bottom برای یک پاراگراف یا سلول جدول قابل استفاده است در حالی که BorderType.DiagonalDown مرز مورب را فقط در یک سلول جدول مشخص می کند.

هر دو مجموعه مرزی و هر مرز جداگانه دارای ویژگی های مشابهی مانند رنگ، سبک خط، عرض خط، فاصله از متن و سایه اختیاری هستند. آنها با ویژگی های یک نام نشان داده می شوند. شما می توانید با ترکیب ارزش ملک به انواع مختلف مرز دست یابید. علاوه بر این، هر دو شی BorderCollection و Border به شما اجازه می دهند که این مقادیر را با فراخوانی روش ClearFormatting به حالت پیش فرض تنظیم کنید.

توجه داشته باشید که وقتی ویژگی های مرزی به مقادیر پیش فرض تنظیم می شوند، مرز نامرئی است.

Aspose.Words همچنین دارای کلاس Shading است که شامل ویژگی های سایه گذاری برای عناصر سند است. شما می توانید بافت سایه مورد نظر و رنگ هایی که به پس زمینه و پیش زمینه عنصر اعمال می شود را تنظیم کنید.

بافت سایه با مقدار TextureIndex شمارش تنظیم شده است که اجازه می دهد تا الگوهای مختلف را به شیء Shading اعمال کند. به عنوان مثال، برای تنظیم رنگ پس زمینه برای یک عنصر سند، از مقدار TextureIndex.TextureSolid استفاده کنید و رنگ سایه پیش زمینه را به عنوان مناسب تنظیم کنید. مثال کد زیر نشان می دهد که چگونه مرزها و سایه ها را به یک پاراگراف اعمال کنید.

مثال کد زیر نشان می دهد که چگونه مرزها و سایه ها را به یک پاراگراف اعمال کنید: