Làm việc với Danh sách
Lầm việc với Danh sách
Hướng dẫn này cho thấy cách các danh sách có số thứ tự và có dấu đầu dòng được biểu diễn và kiểm soát trong Aspose.Words FOSS cho .NET. Một List là định nghĩa danh sách có thể tái sử dụng được chia sẻ bởi mỗi đoạn văn sử dụng nó, ListFormat là cách một đoạn văn riêng lẻ tham chiếu toàn danh sách và cấp độ hiện tại của nó, và ListLevel chứa định dạng đánh số hoặc dấu đầu dòng thực tế cho một cấp độ của danh sách.
Đối tượng Danh sách và ListCollection
List đại diện cho một định nghĩ danh sách — các quy tắc đánh số mà tài liệu có thể áp dụng cho nhiều đoạn văn. List.ListId xác định nó, List.IsMultiLevel báo cáo liệu nó có định nghĩ hơn một cấp độ hay không, và List.ListLevels trả về một ListLevelCollection chứa một ListLevel cho mỗi cấp độ mà danh sách định nghĩ. List.IsListStyleDefinition và IsListStyleReference phân biệt danh sách tự định dạng của nó với danh sách tham chiếu định dạng qua một Style được liên kết (có sẵn thông qua List.Style). Các danh sách của mỗi tài liệu được truy cập qua Document.Lists, mà trả về một ListCollection: ListCollection.Add(listTemplate) tạo một danh sách mới từ một trong các định dạng ListTemplate được Word định sẵn, Add(listStyle) tạo một danh sách từ một Style, AddSingleLevelList(listTemplate) tạo một biến thế một cấp độ, và AddCopy(srcList) sao chép một danh sách hiện có — hữu ích khi bạn muốn các đoạn văn có số thứ tự độc lập (bắt đầu mới) thay vì chia sẻ cùng một bộ đếm. ListCollection.GetListByListId(listId) lấy một danh sách cụ thể, và Count báo cáo số lượng danh sách mà tài liệu có.
Áp dụng Danh sách cho Độn văn với ListFormat
ListFormat, được truy cập từ định dạng của đoạn văn, kiểm sót danh sách nào mà đoạn văn thuộc và ở cấp độ nào. ListFormat.List là List mà đoạn văn sử dụng, và ListFormat.ListLevelNumber là cấp độ dựa trên chỉ số 0 trong danh sách đó; IsListItem báo cáo liệu đoạn văn có thuộc một danh sách hay không. ApplyBulletDefault() và ApplyNumberDefault() áp dụng định dạng danh sách dấu đầu dòng hoặc có số thứ tự mặc định của Word cho một đoạn văn trong một lần gọi, RemoveNumbers() loại bỏ định dạng danh sách, và ListIndent()/ListOutdent() di chuyển đoạn văn sâu hơn vào hoặc nông hơn ra các cấp độ của danh sách — các thao tác tương tự mà Word thực hiện khi nhấn Tab hoặc Shift+Tab ở đầu một đoạn văn danh sách.
Cấp độ Danh sách và Kiểu Đánh số
ListLevel chứa định dạng cho một cấp độ của danh sách: NumberStyle (một giá trị enum NumberStyle như số Ả Rập hoặc số La Mã), NumberFormat (chuỗi định dạng kết hợp số với văn bản cố định, chẳng hạn dấu chấm hoặc dấu ngoặc), StartAt (số bắt đầu), và RestartAfterLevel (cấp độ cao hơn nào tăng sẽ khởi động lại bộ đếm của cấp độ này). Alignment (một giá trị ListLevelAlignment: Left, Center, Right) và TrailingCharacter (một giá trị ListTrailingCharacter: Tab, Space, Nothing) điều khiển cách nhãn được đặt vị trí và tách ra khỏi văn bản đoạn, cùng với TabPosition, NumberPosition và TextPosition để bố trí chính xác. IsLegal buộc đánh số kiểu pháp lý (luôn là số Ả Rập, bất kể NumberStyle), và LinkedStyle liên kết cấp độ với một đoạn Style. Đối với các đầu mục ảnh, CreatePictureBullet() và DeletePictureBullet() quản lý một hình ảnh đầu mục ImageData, và ListLevel.Font đặt định dạng cho số hoặc ký tự đầu mục. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) tính giá trị nhãn thực tế tại vị trí nhất định trong chuỗi đánh số.
Nhãn Danh sách và Mẫu Được Định Nghĩa Trước
ListLabel mô tả nhãn đã được hiển thị cho một thể hiện mục danh sách cụ thể — LabelString là văn bản nguyên gốc mà Word hiển thị (ví dụ “3.” hoặc “•”), LabelValue là giá trị số nguyên dưới lớp, và Font là định dạng của nhãn. ListTemplate là một enum của các định dạng danh sách đã được Word định nghĩa sẵn (các kiểu đầu mục như BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds, và các định dạng có số), được sử dụng cùng với ListCollection.Add(listTemplate) để bắt đầu từ một định dạng tích hợp sẵn thay vì xây dựng từng thuộc tính một.
Mẹo và Thực hành Tốt nhất
- Sử dụng
ListCollection.AddCopy(srcList)khi một nhóm đoạn mới cần đánh số danh sách bắt đầu lại một cách độc lập, thay vì tái sử dụngListđã được gắn vào các đoạn khác. - Ưu tiên
ListFormat.ApplyNumberDefault()/ApplyBulletDefault()cho các danh sách tiêu chuẩn thay vì cấu hình thủ công từng thuộc tínhListLevel. - Kiểm tra
List.IsListStyleReferenceso vớiIsListStyleDefinitiontrước khi chỉnh sửa định dạng danh sách trực tiếp — định dạng của danh sách tham chiếu kiểu có thể được kiểm soát bởiStyleđược liên kết thay thế. - Đặt
RestartAfterLevelmộ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 khi cần đặt lại số ở các cấp độ đề cương cụ thể. - Sử dụng
ListFormat.ListIndent()/ListOutdent()để di chuyển một đoạn văn giữa các cấp danh sách thay vì thiết lậpListLevelNumbertrực tiếp, vì các phương pháp này giữ cho định dạng danh sách của đoạn văn nhất quán nội bộ.
Các vấn đề thường gặp
| Vấn đề | Nguyên nhân | Khắc phục |
|---|---|---|
| Hai đoạn văn cần đánh số độc lập vẫn tiếp tục cùng một chuỗi | Cả hai đoạn văn ListFormat.List đều tham chiếu tới cùng một đối tượng List chung | Cung cấp cho đoạn văn thứ hai danh sách riêng thông qua ListCollection.AddCopy(srcList) thay vì tái sử dụng cùng List |
| Chuỗi định dạng đánh số tùy chỉnh không hiển thị như mong đợi | ListLevel.NumberFormat không khớp với mẫu mong đợi cho NumberStyle của cấp độ | Xác minh NumberFormat và NumberStyle được đặt một cách nhất quán cho cấp độ đang được chỉnh sửa |
| Khoảng thụt lề danh sách trông sai sau khi thay đổi cấp độ bằng chương trình | ListLevelNumber đã được đặt trực tiếp mà không cập nhật các thuộc tính vị trí liên quan | Sử dụng ListFormat.ListIndent()/ListOutdent() thay vì đặt ListLevelNumber trực tiếp |
| Không hiển thị dấu đầu dòng hình ảnh | Không có dấu đầu dòng hình ảnh nào được tạo cho cấp độ, hoặc định dạng dấu đầu dòng văn bản mặc định vẫn đang hoạt động | Gọi ListLevel.CreatePictureBullet() và cung cấp dữ liệu hình ảnh trước khi xóa định dạng dấu đầu dòng văn bản |
FAQ
Sự khác biệt giữa List và ListFormat là gì?
List là định nghĩa đánh số/đánh dấu có thể tái sử dụng được chia sẻ giữa các đoạn; ListFormat là riêng cho mỗi đoạn — nó chỉ ra List mà một đoạn cụ thể sử dụng và cấp độ nào, thông qua ListFormat.List và ListLevelNumber.
Làm sao tôi kiểm tra xem một đoạn văn có phải là một phần của danh sách không?
Đọc ListFormat.IsListItem về định dạng của đoạn văn; nếu true, ListFormat.List và ListLevelNumber mô tả danh sách và cấp độ mà nó thuộc về.
Làm sao để danh sách mới bắt đầu đánh số từ 1 một cách độc lập với danh sách hiện có?
Sử dụng ListCollection.AddCopy(srcList) để tạo một bản sao độc lập của định nghĩa danh sách, sau đó áp dụng bản sao này cho các đoạn mới — thay vì tái sử dụng List gốc, điều đó sẽ tiếp tục cùng bộ đếm.
Làm thế nào để tôi tạo một danh sách có dấu đầu dòng hoặc đánh số từ đầu?
Sử dụng ListFormat.ApplyBulletDefault() hoặc ApplyNumberDefault() cho định dạng mặc định của Word, hoặc ListCollection.Add(listTemplate) với giá trị ListTemplate để bắt đầu từ một trong các định dạng được Word định sẵn và tùy chỉnh List.ListLevels kết quả từ đó.
Làm sao tôi có thể kiểm soát định dạng số, chẳng hạn như “1)” thay vì “1.”?
Đặt ListLevel.NumberFormat ở cấp độ liên quan thành chuỗi định dạng mong muốn, cùng với NumberStyle cho kiểu số nguyên bản thân nó.
API Reference Tóm tắt
| Lớp/Phương thức | Mô tả |
|---|---|
List | Định nghĩa danh sách có thể tái sử dụng (đánh số/dấu đầu dòng) |
ListCollection | Tập hợp tất cả các danh sách trong tài liệu |
ListCollection.Add(listTemplate) / AddCopy(srcList) | Tạo một danh sách từ mẫu đã định sẵn, hoặc sao chép một danh sách hiện có |
ListFormat | Tham chiếu theo đoạn văn tới một List và cấp độ hiện tại |
ListFormat.ApplyBulletDefault() / ApplyNumberDefault() | Áp dụng định dạng đầu dòng hoặc đánh số mặc định cho một đoạn văn |
ListLevel | Định dạng đánh số/đầu dòng cho một cấp của List |
ListLevel.NumberStyle / NumberFormat | Kiểu số và chuỗi định dạng cho một cấp |
ListLabel | Nhãn đã hiển thị (văn bản và giá trị) cho một mục danh sách cụ thể |
ListTemplate | Enum của các định dạng danh sách được định sẵn của Word |