Cách làm việc với danh sách trong .NET

Bước 1: Áp dụng danh sách vào một đoạn văn

Sử dụng ListFormat.ApplyBulletDefault() hoặc ApplyNumberDefault() trên định dạng của một đoạn văn để áp dụng danh sách dấu chấm hoặc đánh số mặc định của Word trong một lần gọi — đây là cách nhanh nhất để áp dụng danh sách tiêu chuẩn. Đối với một định dạng đã được định nghĩa sẵn cụ thể thay vì mặc định, gọi Document.Lists (một ListCollection) .Add(listTemplate) với giá trị ListTemplate như BulletDisk, BulletSquare, NumberArabicDot, hoặc NumberUppercaseRomanDot để tạo một List từ một trong các định dạng tích hợp của Word, hoặc AddSingleLevelList(listTemplate) cho một biến thể một cấp độ. Khi một đoạn văn có định dạng danh sách, ListFormat.IsListItem báo cáo true, và ListFormat.List/ListLevelNumber xác định danh sách và cấp độ mà nó sử dụng.

Bước 2: Cung cấp cho một nhóm đoạn văn mới việc đánh số độc lập

Các đoạn văn mà ListFormat.List chỉ tới cùng một đối tượng List chung sẽ tiếp tục cùng bộ đếm. Khi một nhóm đoạn mới cần đánh số lại từ 1 một cách độc lập, gọi ListCollection.AddCopy(srcList) để sao chép một định nghĩa danh sách hiện có, sau đó áp dụng bản sao cho các đoạn mới thay vì sử dụng lại bản gốc. ListCollection.GetListByListId(listId) lấy một danh sách cụ thể bằng ListId khi bạn cần tra cứu thay vì tạo mới, và Count báo cáo số lượng danh sách hiện có trong tài liệu.

Bước 3: Di chuyển một đoạn văn giữa các cấp danh sách

Sử dụng ListFormat.ListIndent() để di chuyển một đoạn văn sâu hơn một cấp trong danh sách, và ListOutdent() để di chuyển nó lên một cấp — các thao tác tương tự mà Word thực hiện khi nhấn Tab và Shift+Tab ở đầu một đoạn danh sách. Ưu tiên các phương pháp này hơn việc đặt ListLevelNumber trực tiếp, vì chúng giữ định dạng danh sách của đoạn văn nhất quán nội bộ. Gọi RemoveNumbers() để loại bỏ hoàn toàn định dạng danh sách khỏi một đoạn văn.

Bước 4: Tùy chỉnh Định dạng Đánh số của Cấp danh sách

Tiếp cận một cấp cụ thể thông qua List.ListLevels (một ListLevelCollection), sau đó đặt ListLevel.NumberStyle (một giá trị NumberStyle như Arabic, UppercaseRoman, LowercaseLetter, hoặc Bullet) và NumberFormat — chuỗi định dạng kết hợp số với văn bản cố định như dấu chấm hoặc ngoặc — cùng nhau, vì một cặp không khớp sẽ tạo ra việc hiển thị không mong muốn. StartAt đặt số bắt đầu của cấp, và RestartAfterLevel kiểm soát cấp cao hơn nào sẽ làm lại bộ đếm của cấp này — hãy đặt nó một cách rõ ràng trên các danh sách lồng nhau thay vì dựa vào hành vi khởi động lại mặc định. Alignment (Left, Center, Right) và TrailingCharacter (Tab, Space, Nothing) kiểm soát vị trí nhãn và ký tự phân tách giữa nhãn và văn bản đoạn, cùng với TabPosition, NumberPosition, và TextPosition để bố trí chính xác. IsLegal buộc định dạng đánh số kiểu pháp lý (luôn là Arabic) bất kể NumberStyle.

Bước 5: Thêm một dấu đầu dòng ảnh vào Cấp danh sách

Gọi ListLevel.CreatePictureBullet() trên cấp mục tiêu để tạo định nghĩa dấu đầu dòng ảnh, sau đó cung cấp ImageData của dấu đầu dòng trước khi xóa bất kỳ định dạng dấu đầu dòng văn bản nào hiện có trên cùng cấp. Gọi DeletePictureBullet() để xóa dấu đầu dòng ảnh và quay lại định dạng dấu đầu dòng dạng văn bản.

Bước 6: Kiểm tra Nhãn đã hiển thị của Mục danh sách

ListLabel mô tả nhãn thực tế được hiển thị cho một mẫu mục danh sách, được lấy từ định dạng đoạn văn của mục. LabelString là văn bản nguyên gốc mà Word hiển thị — chẳng hạn như “3.” hoặc “•” — LabelValue là giá trị số cơ bản, và Font là định dạng riêng của nhãn, độc lập với định dạng đoạn văn bản. Để tính giá trị của nhãn tại một vị trí bất kỳ trong chuỗi mà không cần hiển thị toàn bộ danh sách, hãy gọi ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat).