کار با لیست ها

یک لیست در یک سند Microsoft Word مجموعه ای از ویژگی های قالب بندی لیست است. لیست ها می توانند در اسناد شما برای قالب بندی، ترتیب و تاکید بر متن استفاده شوند. لیست ها راهی عالی برای سازماندهی داده ها در اسناد هستند و درک نکات کلیدی را برای خوانندگان آسان تر می کنند.

هر لیست می تواند تا 9 سطح داشته باشد و ویژگی های قالب بندی، مانند سبک شماره، ارزش شروع، indent، موقعیت برگه و دیگران به طور جداگانه برای هر سطح تعریف شده است.

این مقاله کار برنامه ریزی شده با لیست ها را با استفاده از Aspose.Words توصیف می کند.

ایجاد لیست با استفاده از قالب بندی لیست

Aspose.Words امکان ایجاد آسان لیست ها را با استفاده از قالب بندی لیست فراهم می کند. DocumentBuilder ویژگی ListFormat را فراهم می کند که یک شی ListFormat را باز می گرداند. این شی دارای چندین روش برای شروع و پایان دادن به یک لیست و افزایش/کاهش شکاف است. دو نوع کلی لیست در Microsoft Word وجود دارد: با گلوله و شماره گذاری:

• برای شروع یک لیست با گلوله، با ListFormat.ApplyBulletDefaultتماس بگیرید
• برای شروع یک لیست شماره گذاری شده، با ListFormat.ApplyNumberDefaultتماس بگیرید

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

در اسناد Word، لیست ها ممکن است تا نه سطح داشته باشند. قالب بندی لیست برای هر سطح مشخص می کند که چه گلوله یا شماره ای استفاده می شود، ترک شده، فضای بین گلوله و متن و غیره. روش های زیر سطح لیست را تغییر می دهند و ویژگی های قالب بندی سطح جدید را اعمال می کنند:

• برای افزایش سطح لیست پاراگراف فعلی به یک سطح، با ListFormat.ListIndentتماس بگیرید
• برای کاهش سطح لیست پاراگراف فعلی به یک سطح، با ListFormat.ListOutdentتماس بگیرید

روش ها سطح لیست را تغییر می دهند و ویژگی های قالب بندی سطح جدید را اعمال می کنند.

همچنین می توانید از ویژگی ListLevelNumber برای دریافت یا تنظیم سطح لیست برای پاراگراف استفاده کنید. سطوح لیست 0 تا 8 شماره گذاری شده اند.

مثال کد زیر نشان می دهد که چگونه یک لیست چند سطحی بسازیم:

مشخص کردن قالب بندی برای یک سطح لیست

اشیاء سطح لیست به طور خودکار ایجاد می شوند زمانی که یک لیست ایجاد می شود. از خواص و روش های کلاس ListLevel برای کنترل قالب بندی سطوح فردی یک لیست استفاده کنید.

لیست راه اندازی مجدد برای هر بخش

شما می توانید یک لیست برای هر بخش را با استفاده از ویژگی IsRestartAtEachSection دوباره راه اندازی کنید. توجه داشته باشید که این گزینه فقط در فرمت های سند RTF، DOC و DOCX پشتیبانی می شود. این گزینه فقط در صورتی به DOCX نوشته می شود که OoxmlCompliance بالاتر از Ecma376 باشد.

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