Sử dụng Thuộc tính Tài liệu trong Aspose.Words cho Java
Giới thiệu về Thuộc tính Tài liệu
Thuộc tính tài liệu là một phần quan trọng của bất kỳ tài liệu nào. Chúng cung cấp thông tin bổ sung về chính tài liệu đó, chẳng hạn như tiêu đề, tác giả, chủ đề, từ khóa, v.v. Trong Aspose.Words cho Java, bạn có thể thao tác cả thuộc tính tài liệu tùy chỉnh và tích hợp sẵn.
Liệt kê các thuộc tính tài liệu
Thuộc tính tích hợp
Để truy xuất và làm việc với các thuộc tính tài liệu tích hợp sẵn, bạn có thể sử dụng đoạn mã sau:
@Test
public void enumerateProperties() throws Exception
{
Document doc = new Document("Your Directory Path" + "Properties.docx");
System.out.println(MessageFormat.format("1. Document name: {0}", doc.getOriginalFileName()));
System.out.println("2. Built-in Properties");
for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
System.out.println(MessageFormat.format("{0} : {1}", prop.getName(), prop.getValue()));
}
Mã này sẽ hiển thị tên của tài liệu và các thuộc tính tích hợp, bao gồm các thuộc tính như “Tiêu đề”, “Tác giả” và “Từ khóa”.
Thuộc tính tùy chỉnh
Để làm việc với các thuộc tính tài liệu tùy chỉnh, bạn có thể sử dụng đoạn mã sau:
@Test
public void addCustomDocumentProperties() throws Exception
{
Document doc = new Document("Your Directory Path" + "Properties.docx");
CustomDocumentProperties customDocumentProperties = doc.getCustomDocumentProperties();
if (customDocumentProperties.get("Authorized") != null) return;
customDocumentProperties.add("Authorized", true);
customDocumentProperties.add("Authorized By", "John Smith");
customDocumentProperties.add("Authorized Date", new Date());
customDocumentProperties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
customDocumentProperties.add("Authorized Amount", 123.45);
}
Đoạn mã này trình bày cách thêm các thuộc tính tài liệu tùy chỉnh, bao gồm giá trị boolean, chuỗi, ngày, số sửa đổi và giá trị số.
Xóa thuộc tính tài liệu
Để xóa các thuộc tính tài liệu cụ thể, bạn có thể sử dụng đoạn mã sau:
@Test
public void removeCustomDocumentProperties() throws Exception
{
Document doc = new Document("Your Directory Path" + "Properties.docx");
doc.getCustomDocumentProperties().remove("Authorized Date");
}
Mã này xóa thuộc tính tùy chỉnh “Ngày được ủy quyền” khỏi tài liệu.
Định cấu hình liên kết đến nội dung
Trong một số trường hợp, bạn có thể muốn tạo liên kết trong tài liệu của mình. Đây là cách bạn có thể làm điều đó:
@Test
public void configuringLinkToContent() throws Exception
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.startBookmark("MyBookmark");
builder.writeln("Text inside a bookmark.");
builder.endBookmark("MyBookmark");
CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();
// Thêm thuộc tính liên kết đến nội dung.
DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
customProperty = customProperties.get("Bookmark");
boolean isLinkedToContent = customProperty.isLinkToContent();
String linkSource = customProperty.getLinkSource();
String customPropertyValue = customProperty.getValue().toString();
}
Đoạn mã này trình bày cách tạo dấu trang trong tài liệu của bạn và thêm thuộc tính tài liệu tùy chỉnh liên kết đến dấu trang đó.
Chuyển đổi giữa các đơn vị đo lường
Trong Aspose.Words for Java, bạn có thể chuyển đổi đơn vị đo lường một cách dễ dàng. Đây là một ví dụ về cách thực hiện:
@Test
public void convertBetweenMeasurementUnits() throws Exception
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
PageSetup pageSetup = builder.getPageSetup();
// Đặt lề theo inch.
pageSetup.setTopMargin(ConvertUtil.inchToPoint(1.0));
pageSetup.setBottomMargin(ConvertUtil.inchToPoint(1.0));
pageSetup.setLeftMargin(ConvertUtil.inchToPoint(1.5));
pageSetup.setRightMargin(ConvertUtil.inchToPoint(1.5));
pageSetup.setHeaderDistance(ConvertUtil.inchToPoint(0.2));
pageSetup.setFooterDistance(ConvertUtil.inchToPoint(0.2));
}
Đoạn mã này đặt các lề và khoảng cách khác nhau tính bằng inch bằng cách chuyển đổi chúng thành điểm.
Sử dụng ký tự điều khiển
Ký tự điều khiển có thể hữu ích khi xử lý văn bản. Sau đây là cách thay thế ký tự điều khiển trong văn bản của bạn:
@Test
public void useControlCharacters()
{
final String TEXT = "test\r";
// Thay thế ký tự điều khiển "\r" bằng "\r\n".
String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}
Trong ví dụ này, chúng tôi thay thế dấu xuống dòng (\r
) với một dấu xuống dòng theo sau là một dòng cấp dữ liệu (\r\n
).
Phần kết luận
Thuộc tính tài liệu đóng một vai trò quan trọng trong việc quản lý và sắp xếp tài liệu của bạn một cách hiệu quả trong Aspose.Words for Java. Cho dù đó là làm việc với các thuộc tính tích hợp, thuộc tính tùy chỉnh hay sử dụng các ký tự điều khiển, bạn đều có sẵn một loạt công cụ để nâng cao khả năng quản lý tài liệu của mình.
Câu hỏi thường gặp
Làm cách nào để truy cập các thuộc tính tài liệu tích hợp?
Để truy cập các thuộc tính tài liệu tích hợp trong Aspose.Words cho Java, bạn có thể sử dụnggetBuiltInDocumentProperties
phương pháp trênDocument
sự vật. Phương thức này trả về một tập hợp các thuộc tính tích hợp mà bạn có thể lặp lại.
Tôi có thể thêm thuộc tính tài liệu tùy chỉnh vào tài liệu không?
Có, bạn có thể thêm thuộc tính tài liệu tùy chỉnh vào tài liệu bằng cách sử dụngCustomDocumentProperties
bộ sưu tập. Bạn có thể xác định các thuộc tính tùy chỉnh với nhiều loại dữ liệu khác nhau, bao gồm chuỗi, boolean, ngày tháng và giá trị số.
Làm cách nào để xóa thuộc tính tài liệu tùy chỉnh cụ thể?
Để xóa một thuộc tính tài liệu tùy chỉnh cụ thể, bạn có thể sử dụngremove
phương pháp trênCustomDocumentProperties
bộ sưu tập, chuyển tên của thuộc tính bạn muốn xóa làm tham số.
Mục đích của việc liên kết đến nội dung trong tài liệu là gì?
Liên kết đến nội dung trong tài liệu cho phép bạn tạo các tham chiếu động tới các phần cụ thể của tài liệu. Điều này có thể hữu ích cho việc tạo tài liệu tương tác hoặc tham khảo chéo giữa các phần.
Làm cách nào tôi có thể chuyển đổi giữa các đơn vị đo lường khác nhau trong Aspose.Words cho Java?
Bạn có thể chuyển đổi giữa các đơn vị đo lường khác nhau trong Aspose.Words cho Java bằng cách sử dụngConvertUtil
lớp học. Nó cung cấp các phương pháp để chuyển đổi các đơn vị như inch thành điểm, điểm thành cm, v.v.