演示文稿属性

Microsoft PowerPoint 提供了一项功能，可以向演示文稿文件添加一些属性。这些文档属性允许将一些有用的信息与文档（演示文稿文件）一起存储。文档属性有两种类型，如下所示：

系统定义的（内置）属性
用户定义的（自定义）属性

内置属性包含有关文档的一般信息，例如文档标题、作者姓名、文档统计信息等。自定义属性是由用户定义的名称/值对，其中名称和值均由用户定义。通过 Java 的 Aspose.Slides for Android，开发人员可以访问和修改内置属性以及自定义属性的值。

PowerPoint 中的文档属性

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

请注意，您无法为 Application 和 Producer 字段设置值，因为 Aspose Ltd. 和 Aspose.Slides for Android via Java x.x.x 将显示在这些字段中。

选择高级属性菜单项	**

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

属性对话框	**

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

使用 Aspose.Slides for Android via Java 操作文档属性

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

开发人员可以使用 Presentation 对象公开的 IDocumentProperties 属性来访问演示文稿文件的文档属性，如下所述：

访问内置属性

这些由 IDocumentProperties 对象公开的属性包括：创建者（作者）、描述、关键字、创建时间、修改时间、最后打印时间、最后修改者、关键字、共享文档（是否在不同的生产者之间共享？）、演示文稿格式、主题和标题。

// 实例化代表演示文稿的 Presentation 类
Presentation pres = new Presentation("Presentation.pptx");
try {
    // 创建与演示文稿关联的 IDocumentProperties 对象的引用
    IDocumentProperties dp = pres.getDocumentProperties();
    
    // 显示内置属性
    System.out.println("分类 : " + dp.getCategory());
    System.out.println("当前状态 : " + dp.getContentStatus());
    System.out.println("创建日期 : " + dp.getCreatedTime());
    System.out.println("作者 : " + dp.getAuthor());
    System.out.println("描述 : " + dp.getComments());
    System.out.println("关键字 : " + dp.getKeywords());
    System.out.println("最后修改者 : " + dp.getLastSavedBy());
    System.out.println("主管 : " + dp.getManager());
    System.out.println("修改日期 : " + dp.getLastSavedTime());
    System.out.println("演示文稿格式 : " + dp.getPresentationFormat());
    System.out.println("最后打印日期 : " + dp.getLastPrinted());
    System.out.println("不同生产者之间是否共享 : " + dp.getSharedDoc());
    System.out.println("主题 : " + dp.getSubject());
    System.out.println("标题 : " + dp.getTitle());
} finally {
    if (pres != null) pres.dispose();
}

修改内置属性

修改演示文稿文件的内置属性与访问它们一样简单。您只需将字符串值分配给任何所需的属性，属性值将被修改。在下面给出的示例中，我们展示了如何使用 Aspose.Slides for Android via Java 修改演示文稿文件的内置文档属性。

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

此示例修改演示文稿的内置属性，可以查看如下所示：

修改后的内置文档属性	**

添加自定义文档属性

Aspose.Slides for Android via Java 还允许开发人员为演示文稿文档属性添加自定义值。以下是一个示例，展示如何为演示文稿设置自定义属性。

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

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

访问和修改自定义属性

Aspose.Slides for Android via Java 还允许开发人员访问自定义属性的值。以下是一个示例，展示如何访问和修改所有这些自定义属性的演示文稿。

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

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

修改前的自定义属性	**

修改后的自定义属性	**

高级文档属性

新增的方法 ReadDocumentProperties、UpdateDocumentProperties 和 WriteBindedPresentation 已添加到 IPresentationInfo，IDocumentProperties.setLastSavedTime 属性设置器的逻辑已更改。

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

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

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

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

// 设置作者和标题字段的新值
props.setAuthor("新作者");
props.setTitle("新标题");

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

还有另一种方法可以使用特定演示文稿的属性作为模板来更新其他演示文稿中的属性：

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

template.setAuthor("模板作者");
template.setTitle("模板标题");
template.setCategory("模板类别");
template.setKeywords("关键字1, 关键字2, 关键字3");
template.setCompany("我们的公司");
template.setComments("根据模板创建");
template.setContentType("模板内容");
template.setSubject("模板主题");

updateByTemplate("doc1.pptx", template);
updateByTemplate("doc2.odp", template);
updateByTemplate("doc3.ppt", template);

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

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

DocumentProperties template = new DocumentProperties();\

template.setAuthor("模板作者");
template.setTitle("模板标题");
template.setCategory("模板类别");
template.setKeywords("关键字1, 关键字2, 关键字3");
template.setCompany("我们的公司");
template.setComments("根据模板创建");
template.setContentType("模板内容");
template.setSubject("模板主题");

updateByTemplate("doc1.pptx", template);
updateByTemplate("doc2.odp", template);
updateByTemplate("doc3.ppt", template);

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

检查演示文稿是否已修改或创建

Aspose.Slides for Android via Java 提供检查演示文稿是否已修改或创建的功能。下面的示例展示了如何检查演示文稿是创建还是修改的。

IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo("props.pptx");

IDocumentProperties props = info.readDocumentProperties();
String app = props.getNameOfApplication();
String ver = props.getAppVersion();

System.out.println("应用程序名称: " + app);
System.out.println("应用程序版本: " + ver);

设置校对语言

Aspose.Slides 提供了 LanguageId 属性（由 PortionFormat 类公开），允许您为 PowerPoint 文档设置校对语言。校对语言是检查 PowerPoint 中拼写和语法的语言。

以下 Java 代码演示如何为 PowerPoint 设置校对语言：xxx 为什么 Java PortionFormat 类缺少 LanguageId？

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 演示文稿设置默认语言：

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("新文本");

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

演示安全演示文稿评论