Làm việc với Kiểu và Chủ đề
Lớp StyleCollection được sử dụng để quản lý tích hợp sẵn và áp dụng các cài đặt do người dùng xác định cho kiểu.
Truy cập kiểu
Bạn có thể lấy tập hợp các kiểu được xác định trong tài liệu bằng thuộc tính Document.styles. Bộ sưu tập này chứa cả kiểu dựng sẵn và kiểu do người dùng xác định trong tài liệu. Một kiểu cụ thể có thể được lấy theo tên/bí danh, mã định danh kiểu hoặc chỉ mục của nó. Ví dụ mã sau đây minh họa cách truy cập vào bộ sưu tập các kiểu được xác định trong tài liệu.
Cách trích xuất nội dung dựa trên kiểu
Ở mức độ đơn giản, việc truy xuất nội dung dựa trên các kiểu từ tài liệu Word có thể hữu ích để xác định, liệt kê và đếm các đoạn văn cũng như số dòng văn bản được định dạng theo một kiểu cụ thể. Ví dụ: bạn có thể cần xác định các loại nội dung cụ thể trong tài liệu, chẳng hạn như ví dụ, tiêu đề, tài liệu tham khảo, từ khóa, tên hình và nghiên cứu trường hợp.
Để tiến thêm một vài bước nữa, điều này cũng có thể được sử dụng để tận dụng cấu trúc của tài liệu, được xác định bởi các kiểu mà nó sử dụng, nhằm tái sử dụng tài liệu cho một đầu ra khác, chẳng hạn như HTML. Trên thực tế, đây là cách xây dựng tài liệu Aspose, đưa Aspose.Words vào thử nghiệm. Một công cụ được xây dựng bằng Aspose.Words lấy tài liệu Word nguồn và chia chúng thành các chủ đề ở các cấp tiêu đề nhất định. Một tệp XML được tạo bằng Aspose.Words được sử dụng để xây dựng cây điều hướng mà bạn có thể thấy ở bên trái. Và sau đó Aspose.Words chuyển đổi từng chủ đề thành HTML.
Giải pháp truy xuất văn bản được định dạng theo các kiểu cụ thể trong tài liệu Word thường tiết kiệm và đơn giản khi sử dụng Aspose.Words.
Giải pháp
Để minh họa cách Aspose.Words xử lý việc truy xuất nội dung dựa trên kiểu dễ dàng như thế nào, hãy xem một ví dụ. Trong ví dụ này, chúng ta sẽ truy xuất văn bản được định dạng bằng một kiểu đoạn văn cụ thể và một kiểu ký tự từ một tài liệu Word mẫu. Ở mức độ cao, điều này sẽ liên quan đến:
- Mở văn bản Word sử dụng lớp Document.
- Lấy bộ sưu tập của tất cả các đoạn văn và tất cả các dòng trong tài liệu.
- Chỉ chọn những đoạn văn cần thiết và chạy. Cụ thể, chúng tôi sẽ truy xuất văn bản được định dạng bằng kiểu đoạn văn ‘Tiêu đề 1’ và kiểu ký tự ‘Nhấn mạnh mạnh mẽ’ từ tài liệu Word mẫu này.
Trong tài liệu mẫu này, văn bản được định dạng bằng kiểu đoạn văn ‘Tiêu đề 1’ là ‘Chèn tab’, ‘Phong cách nhanh’ và ‘Chủ đề’ và văn bản được định dạng bằng kiểu ký tự ‘Nhấn mạnh mạnh’ là một số trường hợp có màu xanh lam, văn bản in nghiêng, in đậm chẳng hạn như ‘phòng trưng bày’ và ‘cái nhìn tổng thể’.
Mật mã
Việc triển khai truy vấn dựa trên kiểu khá đơn giản trong mô hình đối tượng tài liệu Aspose.Words vì nó chỉ sử dụng các công cụ đã có sẵn. Hai phương thức lớp được triển khai cho giải pháp này:
- đoạn_by_style_name – Phương thức này truy xuất một mảng gồm các đoạn văn trong tài liệu có tên kiểu cụ thể.
- run_by_style_name – Phương thức này truy xuất một mảng gồm các lần chạy trong tài liệu có tên kiểu cụ thể. Cả hai phương pháp này đều rất giống nhau, điểm khác biệt duy nhất là các loại nút và cách trình bày thông tin kiểu trong đoạn văn và các nút chạy. Đây là cách triển khai
paragraphs_by_style_name: Ví dụ bên dưới tìm tất cả các đoạn được định dạng theo kiểu đã chỉ định.
Việc triển khai này cũng sử dụng phương thức Document.get_child_nodes của lớp Document, trả về một tập hợp tất cả các nút có loại đã chỉ định, trong trường hợp này là trong tất cả các đoạn.
Lưu ý rằng tham số thứ hai của phương pháp Document.get_child_nodes được đặt thành True. Điều này buộc phương thức Document.get_child_nodes phải chọn đệ quy từ tất cả các nút con, thay vì chỉ chọn các nút con ngay lập tức.
Cũng cần chỉ ra rằng bộ sưu tập đoạn văn không tạo ra chi phí ngay lập tức vì các đoạn văn chỉ được tải vào bộ sưu tập này khi bạn truy cập các mục trong đó. Sau đó, tất cả những gì bạn cần làm là xem qua bộ sưu tập, sử dụng toán tử foreach tiêu chuẩn và thêm các đoạn văn có kiểu được chỉ định vào mảng đoạn văn_with_style. Tên kiểu Paragraph có thể được tìm thấy trong thuộc tính Style.name của đối tượng Paragraph.paragraph_format. Việc triển khai run_by_style_name gần như giống nhau, mặc dù rõ ràng là chúng tôi đang sử dụng NodeType.RUN để truy xuất các nút đang chạy. Thuộc tính Font.style của đối tượng Run được sử dụng để truy cập thông tin kiểu trong các nút Run. Ví dụ dưới đây tìm tất cả các lần chạy được định dạng với kiểu đã chỉ định.
Khi cả hai truy vấn được triển khai, tất cả những gì bạn cần làm là truyền một đối tượng tài liệu và chỉ định tên kiểu của nội dung bạn muốn truy xuất: Ví dụ dưới đây chạy truy vấn và hiển thị kết quả. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.
Kết quả cuối cùng
Khi mọi thứ hoàn tất, việc chạy mẫu sẽ hiển thị kết quả sau:
Như bạn có thể thấy, đây là một ví dụ rất đơn giản, hiển thị số lượng và văn bản của các đoạn văn đã thu thập và chạy trong tài liệu Word mẫu.
Sao chép tất cả các kiểu từ mẫu
Có những trường hợp bạn muốn sao chép tất cả các kiểu từ tài liệu này sang tài liệu khác. Bạn có thể sử dụng phương pháp Document.copy_styles_from_template để sao chép kiểu từ mẫu đã chỉ định sang tài liệu. Khi kiểu được sao chép từ mẫu sang tài liệu, các kiểu có tên giống nhau trong tài liệu sẽ được xác định lại để khớp với mô tả kiểu trong mẫu. Các kiểu độc đáo từ mẫu sẽ được sao chép vào tài liệu. Các kiểu duy nhất trong tài liệu vẫn được giữ nguyên. Ví dụ Below code cho thấy cách sao chép kiểu từ tài liệu này sang tài liệu khác.
Cách thao tác thuộc tính chủ đề
Chúng tôi đã thêm API cơ bản vào Aspose.Words để truy cập các thuộc tính chủ đề tài liệu. Hiện tại, API này bao gồm các đối tượng công khai sau:
Đây là cách bạn có thể nhận được các thuộc tính chủ đề:
Và đây là cách bạn có thể đặt thuộc tính chủ đề: