在 Java 中管理演示文稿属性

本页内容简介

在 Aspose.Slides for Java 中掌握演示文稿属性，并简化 PowerPoint 和 OpenDocument 文件的搜索、品牌化和工作流。

介绍

Aspose.Slides 支持两种文档属性：内置和 自定义。这两种属性类型都可以通过 Aspose.Slides API 轻松访问和管理。

Aspose.Slides 允许您通过 IDocumentProperties 接口对演示文稿的文档属性进行操作。该接口的实例由 Presentation.getDocumentProperties 方法返回。下面的示例展示了如何读取、修改和管理这些属性。

Note

请注意，Application 和 AppVersion 字段无法修改。Aspose.Slides 在每次保存时都会重新写入它们，因此保存的演示文稿始终显示 “Aspose.Slides for Java” 以及生成该文稿的库版本。传递给 setNameOfApplication 的任何值在写入演示文稿时都会被丢弃。

PowerPoint 中的文档属性

Microsoft PowerPoint 2007 允许管理演示文稿文件的文档属性。只需单击 Office 图标，然后选择 准备 | 属性 | 高级属性 菜单项，如下所示：

选择高级属性菜单项	**

选择 高级属性 菜单项后，会出现如下对话框，允许您管理 PowerPoint 文件的文档属性：

属性对话框	**

在上述 属性对话框 中，您可以看到多个选项卡页面，如常规、摘要、统计信息、内容和 自定义。所有这些选项卡页面均用于配置与 PowerPoint 文件相关的不同信息。自定义 选项卡用于管理 PowerPoint 文件的自定义属性。

使用 Aspose.Slides for Java 处理文档属性

正如前文所述，Aspose.Slides for Java 支持两类文档属性，即内置和 自定义 属性。因此，开发人员可以使用 Aspose.Slides for Java API 访问这两类属性。Aspose.Slides for Java 提供了一个 IDocumentProperties 类，代表通过 Presentation.DocumentProperties 属性关联的演示文稿文件的文档属性。

开发人员可以通过 Presentation 对象公开的 IDocumentProperties 属性来访问演示文稿文件的文档属性，示例如下：

访问内置属性

IDocumentProperties 对象公开的这些属性包括：Creator（作者）、Description、Keywords、Created（创建日期）、Modified（修改日期）、Printed（最近打印日期）、LastModifiedBy、SharedDoc（是否在不同制作者之间共享？）、PresentationFormat、Subject 和 Title。

import com.aspose.slides.*;

// 实例化表示演示文稿的 Presentation 类
Presentation pres = new Presentation("Presentation.pptx");
try {
    // 创建与 Presentation 关联的 IDocumentProperties 对象的引用
    IDocumentProperties dp = pres.getDocumentProperties();
    
    // 显示内置属性
    System.out.println("Category : " + dp.getCategory());
    System.out.println("Current Status : " + dp.getContentStatus());
    System.out.println("Creation Date : " + dp.getCreatedTime());
    System.out.println("Author : " + dp.getAuthor());
    System.out.println("Description : " + dp.getComments());
    System.out.println("KeyWords : " + dp.getKeywords());
    System.out.println("Last Modified By : " + dp.getLastSavedBy());
    System.out.println("Supervisor : " + dp.getManager());
    System.out.println("Modified Date : " + dp.getLastSavedTime());
    System.out.println("Presentation Format : " + dp.getPresentationFormat());
    System.out.println("Last Print Date : " + dp.getLastPrinted());
    System.out.println("Is Shared between producers : " + dp.getSharedDoc());
    System.out.println("Subject : " + dp.getSubject());
    System.out.println("Title : " + dp.getTitle());
} finally {
    if (pres != null) pres.dispose();
}

修改内置属性

修改演示文稿文件的内置属性与访问它们一样简单。您只需为任意所需属性分配字符串值，即可修改该属性的值。下面的示例演示了如何使用 Aspose.Slides for Java 修改演示文稿的内置文档属性。

import com.aspose.slides.*;

Presentation pres = new Presentation("Presentation.pptx");
try {
    // 创建与 Presentation 关联的 IDocumentProperties 对象的引用
    IDocumentProperties dp = pres.getDocumentProperties();
    
    // 设置内置属性
    dp.setAuthor("Aspose.Slides for Java");
    dp.setTitle("Modifying Presentation Properties");
    dp.setSubject("Aspose Subject");
    dp.setComments("Aspose Description");
    dp.setManager("Aspose Manager");
    
    // 将演示文稿保存到文件
    pres.save("DocProps.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

此示例修改了演示文稿的内置属性，修改后效果如下所示：

修改后内置文档属性	**

添加自定义文档属性

Aspose.Slides for Java 还允许开发人员为演示文稿的文档属性添加自定义值。下面的示例添加了三个自定义属性，然后查找索引为 2 的名称并将其移除，最终保存的演示文稿保留了其中的两个。自定义属性按字母顺序索引，而不是添加顺序。

import com.aspose.slides.*;

Presentation pres = new Presentation();
try {
    // 获取文档属性
    IDocumentProperties dProps = pres.getDocumentProperties();
    
    // 添加自定义属性
    dProps.set_Item("New Custom", 12);
    dProps.set_Item("My Name", "Mudassir");
    dProps.set_Item("Custom", 124);
    
    // 获取特定索引处的属性名称
    String getPropertyName = dProps.getCustomPropertyName(2);
    
    // 删除选定属性
    dProps.removeCustomProperty(getPropertyName);
    
    // 保存演示文稿
    pres.save("CustomDemo.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

已添加的自定义文档属性	**

访问并修改自定义属性

Aspose.Slides for Java 还允许开发人员访问自定义属性的值。下面的示例展示了如何访问并修改演示文稿的所有自定义属性。

import com.aspose.slides.*;

Presentation pres = new Presentation("Presentation.pptx");
try {
    // 创建与 Presentation 关联的 DocumentProperties 对象的引用
    IDocumentProperties dp = pres.getDocumentProperties();
    
    // 访问并修改自定义属性
    for (int i = 0; i < dp.getCountOfCustomProperties(); i++) {
        // 显示自定义属性的名称和值
        System.out.println("Custom Property Name : " + dp.getCustomPropertyName(i));
        System.out.println("Custom Property Value : " + dp.get_Item(dp.getCustomPropertyName(i)));
    
        // 修改自定义属性的值
        dp.set_Item(dp.getCustomPropertyName(i), "New Value " + (i + 1));
    }
    
    // 将演示文稿保存到文件
    pres.save("CustomDemoModified.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

此示例修改了 PPTX 演示文稿的自定义属性。以下图示展示了修改前后的自定义属性：

修改前的自定义属性	**

修改后的自定义属性	**

高级文档属性

Note

新增了 ReadDocumentProperties、UpdateDocumentProperties 和 WriteBindedPresentation 方法至 IPresentationInfo，并更改了 IDocumentProperties.setLastSavedTime 属性设置器的实现逻辑。

两个新方法 ReadDocumentProperties 和 UpdateDocumentProperties 已添加到 IPresentationInfo 接口。它们提供了对文档属性的快速访问，并允许在不加载整个演示文稿的情况下更改和更新属性。

典型场景是加载属性、修改某些值后再更新文档，可按以下方式实现：

import com.aspose.slides.*;

// 读取演示文稿信息
IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo("presentation.pptx");

// 获取当前属性
IDocumentProperties props = info.readDocumentProperties();

// 设置 Author 和 Title 字段的新值
props.setAuthor("New Author");
props.setTitle("New Title");

// 使用新值更新演示文稿
info.updateDocumentProperties(props);
info.writeBindedPresentation("presentation.pptx");

还可以将特定演示文稿的属性用作模板，以更新其他演示文稿的属性：

import com.aspose.slides.*;

IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo("template.pptx");
DocumentProperties template = (DocumentProperties) info.readDocumentProperties();

template.setAuthor("Template Author");
template.setTitle("Template Title");
template.setCategory("Template Category");
template.setKeywords("Keyword1, Keyword2, Keyword3");
template.setCompany("Our Company");
template.setComments("Created from template");
template.setContentType("Template Content");
template.setSubject("Template Subject");

for (String path : new String[] { "doc1.pptx", "doc2.odp", "doc3.ppt" }) {
    IPresentationInfo toUpdate = PresentationFactory.getInstance().getPresentationInfo(path);
    toUpdate.updateDocumentProperties(template);
    toUpdate.writeBindedPresentation(path);
}

import com.aspose.slides.*;

private static void updateByTemplate(String path, IDocumentProperties template) 
{
    IPresentationInfo toUpdate = PresentationFactory.getInstance().getPresentationInfo(path);
    toUpdate.updateDocumentProperties(template);
    toUpdate.writeBindedPresentation(path);
}

也可以从头创建新模板，然后用于更新多个演示文稿：

import com.aspose.slides.*;

DocumentProperties template = new DocumentProperties();

template.setAuthor("Template Author");
template.setTitle("Template Title");
template.setCategory("Template Category");
template.setKeywords("Keyword1, Keyword2, Keyword3");
template.setCompany("Our Company");
template.setComments("Created from template");
template.setContentType("Template Content");
template.setSubject("Template Subject");

for (String path : new String[] { "doc1.pptx", "doc2.odp", "doc3.ppt" }) {
    IPresentationInfo toUpdate = PresentationFactory.getInstance().getPresentationInfo(path);
    toUpdate.updateDocumentProperties(template);
    toUpdate.writeBindedPresentation(path);
}

设置校对语言

Aspose.Slides 提供了由 PortionFormat 类公开的 LanguageId 属性，用于设置 PowerPoint 文档的校对语言。校对语言是 PowerPoint 检查拼写和语法时所使用的语言。

下面的 Java 代码演示了如何为 PowerPoint 设置校对语言：

import com.aspose.slides.*;

String pptxFileName = "presentation.pptx";

Presentation pres = new Presentation(pptxFileName);
try {
    AutoShape autoShape = (AutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
    paragraph.getPortions().clear();

    Portion newPortion = new Portion();

    IFontData font = new FontData("SimSun");
    IPortionFormat portionFormat = newPortion.getPortionFormat();
    portionFormat.setComplexScriptFont(font);
    portionFormat.setEastAsianFont(font);
    portionFormat.setLatinFont(font);

    portionFormat.setLanguageId("zh-CN"); // 设置校对语言的 ID

    newPortion.setText("1。");
    paragraph.getPortions().add(newPortion);
} finally {
    if (pres != null) pres.dispose();
}

设置默认语言

下面的 Java 代码演示了如何为整个 PowerPoint 演示文稿设置默认语言：

import com.aspose.slides.*;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setDefaultTextLanguage("en-US");

Presentation pres = new Presentation(loadOptions);
try {
    // 添加一个带文本的新矩形形状
    IAutoShape shp = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 50);
    shp.getTextFrame().setText("New Text");

    // 检查第一个片段的语言
    System.out.println(shp.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().getLanguageId());
} finally {
    if (pres != null) pres.dispose();
}

实时示例

尝试在线应用程序 Aspose.Slides Metadata，了解如何通过 Aspose.Slides API 操作文档属性：

常见问题

如何从演示文稿中移除内置属性？

内置属性是演示文稿的组成部分，无法完全删除。但您可以更改其值，或在特定属性允许的情况下将其设为空。

如果添加的自定义属性已存在会怎样？

如果添加的自定义属性已存在，其原有值将被新值覆盖。无需事先删除或检查属性，因为 Aspose.Slides 会自动更新属性值。

是否可以在不完整加载演示文稿的情况下访问演示文稿属性？

可以。使用 PresentationFactory.getPresentationInfo 然后调用 IPresentationInfo.readDocumentProperties，即可在不创建 Presentation 实例的情况下读取已存储的文档元数据。请参阅构建轻量级演示文稿清单获取完整的报告示例及特定格式的限制。

演示安全性检索和更新 Java 中的演示文稿视图属性