在 Aspose.Words for Java 中使用文档属性

文档属性简介

文档属性是任何文档的重要组成部分。它们提供有关文档本身的其他信息，例如其标题、作者、主题、关键字等。在 Aspose.Words for Java 中，您可以操作内置和自定义文档属性。

枚举文档属性

内置属性

要检索和使用内置文档属性，您可以使用以下代码片段：

@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()));
}

此代码将显示文档的名称和内置属性，包括“标题”、“作者”和“关键字”等属性。

自定义属性

要使用自定义文档属性，您可以使用以下代码片段：

@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);
}

此代码片段演示了如何添加自定义文档属性，包括布尔值、字符串、日期、修订号和数字值。

删除文档属性

要删除特定的文档属性，可以使用以下代码：

@Test
public void removeCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    doc.getCustomDocumentProperties().remove("Authorized Date");
}

此代码从文档中删除自定义属性“授权日期”。

配置内容链接

在某些情况下，您可能希望在文档中创建链接。具体操作如下：

@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();

    //添加链接到内容属性。
    DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
    customProperty = customProperties.get("Bookmark");
    boolean isLinkedToContent = customProperty.isLinkToContent();
    String linkSource = customProperty.getLinkSource();
    String customPropertyValue = customProperty.getValue().toString();
}

此代码片段演示了如何在文档中创建书签并添加链接到该书签的自定义文档属性。

测量单位之间的转换

在 Aspose.Words for Java 中，您可以轻松转换测量单位。以下是如何操作的示例：

@Test
public void convertBetweenMeasurementUnits() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    PageSetup pageSetup = builder.getPageSetup();

    //以英寸为单位设置边距。
    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));
}

此代码片段通过将各种边距和距离转换为点来设置以英寸为单位的各种边距和距离。

使用控制字符

控制字符在处理文本时非常有用。以下是如何替换文本中的控制字符：

@Test
public void useControlCharacters()
{
    final String TEXT = "test\r";

    //用“\r\n”替换“\r”控制字符。
    String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}

在此示例中，我们将回车符 (\r）以回车符结尾，然后换行（\r\n）。

结论

文档属性在 Aspose.Words for Java 中有效管理和组织文档方面发挥着重要作用。无论是使用内置属性、自定义属性还是使用控制字符，您都可以使用一系列工具来增强文档管理功能。

常见问题解答

如何访问内置文档属性？

要访问 Aspose.Words for Java 中的内置文档属性，您可以使用getBuiltInDocumentProperties方法Document对象。此方法返回一个可以迭代的内置属性集合。

我可以向文档添加自定义文档属性吗？

是的，您可以使用CustomDocumentProperties集合。您可以定义具有各种数据类型的自定义属性，包括字符串、布尔值、日期和数值。

如何删除特定的自定义文档属性？

要删除特定的自定义文档属性，您可以使用remove方法CustomDocumentProperties集合，将要删除的属性的名称作为参数传递。

链接到文档内的内容的目的是什么？

通过链接到文档中的内容，您可以创建对文档特定部分的动态引用。这对于创建交互式文档或各部分之间的交叉引用非常有用。

如何在 Aspose.Words for Java 中在不同的测量单位之间进行转换？

您可以使用 Aspose.Words for Java 中的不同测量单位进行转换ConvertUtil类。它提供了将英寸转换为点、将点转换为厘米等单位的方法。