چگونه با لیست‌ها در .NET کار کنیم

مرحله ۱: اعمال فهرست به یک پاراگراف

از ListFormat.ApplyBulletDefault() یا ApplyNumberDefault() بر روی قالب‌بندی یک پاراگراف استفاده کنید تا فهرست بولت یا شماره‌دار پیش‌فرض Word را در یک فراخوانی اعمال کنید — این سریع‌ترین روش برای اعمال یک فهرست استاندارد است. برای یک قالب پیش‌تعریف شده خاص به جای پیش‌فرض، Document.Lists (یک ListCollection) را با .Add(listTemplate) و مقدار ListTemplate مانند BulletDisk، BulletSquare، NumberArabicDot یا NumberUppercaseRomanDot فراخوانی کنید تا یک List از یکی از قالب‌های توکار Word ایجاد کنید، یا AddSingleLevelList(listTemplate) برای یک گونه تک‌سطحی. هنگامی که یک پاراگراف قالب‌بندی فهرست دارد، ListFormat.IsListItem گزارش می‌دهد true، و ListFormat.List/ListLevelNumber تعیین می‌کنند که از کدام فهرست و سطح استفاده می‌کند.

مرحله ۲: اختصاص شماره‌گذاری مستقل به یک گروه جدید از پاراگراف‌ها

پاراگراف‌هایی که ListFormat.List آن‌ها به همان شیء مشترک List اشاره می‌کند، شمارشگر یکسان را ادامه می‌دهند. وقتی یک گروه جدید از پاراگراف‌ها به شماره‌گذاری نیاز دارند که به طور مستقل از ۱ دوباره شروع شود، ListCollection.AddCopy(srcList) را فراخوانی کنید تا تعریف لیست موجود را کپی کنید، سپس این کپی را به پاراگراف‌های جدید اعمال کنید به جای استفاده مجدد از اصلی. ListCollection.GetListByListId(listId) یک لیست خاص را بر اساس ListId آن بازیابی می‌کند وقتی که نیاز دارید یک لیست را پیدا کنید نه اینکه بسازید، و Count گزارش می‌دهد که مستند در حال حاضر چند لیست دارد.

مرحله ۳: جابجایی یک پاراگراف بین سطوح لیست

از ListFormat.ListIndent() برای جابجایی یک پاراگراف یک سطح عمیق‌تر در لیست آن استفاده کنید، و از ListOutdent() برای جابجایی یک سطح کمتر — همان عملیاتی که Word برای Tab و Shift+Tab در ابتدای پاراگراف لیست انجام می‌دهد. ترجیحاً این روش‌ها را به جای تنظیم مستقیم ListLevelNumber استفاده کنید، زیرا قالب‌بندی لیست پاراگراف را به صورت داخلی سازگار نگه می‌دارند. برای حذف کامل قالب‌بندی لیست از یک پاراگراف، RemoveNumbers() را فراخوانی کنید.

مرحله ۴: سفارشی‌سازی قالب شماره‌گذاری سطح لیست

به یک سطح خاص از طریق List.ListLevels (یک ListLevelCollection) دسترسی پیدا کنید، سپس ListLevel.NumberStyle (یک مقدار NumberStyle مانند Arabic، UppercaseRoman، LowercaseLetter یا Bullet) و NumberFormat — رشته قالب که عدد را با متن ثابت مانند نقطه یا پرانتز ترکیب می‌کند — را همزمان تنظیم کنید، زیرا ترکیب نادرست منجر به رندر غیرمنتظره می‌شود. StartAt عدد شروع سطح را تنظیم می‌کند، و RestartAfterLevel تعیین می‌کند که افزایش کدام سطح بالاتر شمارنده این سطح را دوباره راه‌اندازی می‌کند — آن را به‌صورت صریح بر روی لیست‌های تو در تو تنظیم کنید به‌جای اتک به رفتار پیش‌فرض راه‌اندازی مجدد. Alignment (Left، Center، Right) و TrailingCharacter (Tab، Space، Nothing) موقعیت برچسب و جداکننده بین برچسب و متن پاراگراف را کنترل می‌کنند، همراه با TabPosition، NumberPosition و TextPosition برای چیدمان دقیق. IsLegal شماره‌گذاری به سبک قانونی (همیشه عربی) را صرف‌نظر از NumberStyle اعمال می‌کند.

مرحله ۵: افزودن یک نقطه گلوله تصویری به سطح لیست

روی سطح هدف ListLevel.CreatePictureBullet() را فراخوانی کنید تا تعریف نقطه گلوله تصویری ایجاد شود، سپس ImageData گلوله را فراهم کنید قبل از حذف هر قالب‌بندی نقطه گلوله متنی موجود در همان سطح. برای حذف نقطه گلوله تصویری و بازگشت به قالب‌بندی نقطه گلوله مبتنی بر متن، DeletePictureBullet() را فراخوانی کنید.

مرحله ۶: بررسی برچسب رندر شده یک مورد لیست

ListLabel توصیف می‌کند برچسبی که در واقع برای یک نمونه مورد لیست رندر می‌شود، که از قالب‌بندی پاراگراف مورد دسترسی می‌شود. LabelString متن لغوی است که Word نمایش می‌دهد — مانند «3.» یا «•» — LabelValue مقدار عددی زیرین است، و Font قالب‌بندی خود برچسب است، مستقل از قالب‌بندی متن پاراگراف. برای محاسبه مقدار برچسب در موقعیتی دلخواه در دنباله بدون رندر کل لیست، ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) را فراخوانی کنید.