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

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

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

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

قالب بندی فعلی فونت نیز توسط ویژگی font مشخص می شود و قالب بندی فعلی پاراگراف توسط ویژگی paragraph_format تعیین می شود.

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

قالب بندی پاراگراف

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

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

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

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

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

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

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

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

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

جداکننده سبک پاراگراف را شناسایی کنید

Aspose.Words یک ویژگی عمومی break_is_style_separator را در یک کلاس Paragraph فراهم می کند که اجازه می دهد پاراگراف جداکننده سبک را همانطور که در مثال زیر نشان داده شده است شناسایی کنید:

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

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

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

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

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

بافت سایه با یک مقدار شمارش TextureIndex تنظیم شده است که امکان استفاده از الگوهای مختلف را برای شی Shading فراهم می کند. به عنوان مثال، برای تنظیم رنگ پس‌زمینه برای یک عنصر سند، از مقدار TextureIndex.TEXTURE_SOLID استفاده کنید و رنگ سایه‌زنی پیش‌زمینه را متناسب با آن تنظیم کنید. مثال زیر نحوه اعمال مرزها و سایه زدن به یک پاراگراف را نشان می دهد.

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