在 Android 上管理簡報屬性

簡介

Aspose.Slides 支援兩種類型的文件屬性：內建和自訂。這兩種屬性類型都可以透過 Aspose.Slides API 輕鬆存取與管理。

Aspose.Slides 允許您透過 IDocumentProperties 介面處理簡報文件屬性。此介面的實例由 Presentation.getDocumentProperties 方法回傳。以下範例示範如何讀取、修改及管理這些屬性。

請注意，Application 和 Producer 欄位無法修改，因為這些欄位總是會顯示 “Aspose Ltd.” 以及 “Aspose.Slides for Android via Java x.x.x”。

PowerPoint 中的文件屬性

Microsoft PowerPoint 2007 允許管理簡報檔案的文件屬性。您只需要點選 Office 圖示，然後依序點選 Prepare | Properties | Advanced Properties 功能表項目，如下圖所示：

選取「Advanced Properties」功能表項目	**

選取 Advanced Properties 功能表項目後，會出現對話方塊，讓您管理 PowerPoint 檔案的文件屬性，如下圖所示：

屬性對話方塊	**

在上方的 Properties Dialog 中，您可以看到有多個分頁，如 General、Summary、Statistics、Contents 和 Custom。所有這些分頁允許設定與 PowerPoint 檔案相關的不同資訊。Custom 分頁用於管理 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 物件可取得的屬性包括：Creator（作者）、Description、Keywords、Created（建立日期）、Modified（修改日期）、Printed（最後列印日期）、LastModifiedBy、SharedDoc（是否在不同製作者之間共享？）、PresentationFormat、Subject 與 Title。

// 實例化代表簡報的 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 Android via Java 變更簡報檔案的內建文件屬性。

Presentation pres = new Presentation("Presentation.pptx");
try {
    // 建立指向與 Presentation 相關聯的 IDocumentProperties 物件的參考
    IDocumentProperties dp = pres.getDocumentProperties();
    
    // 設定內建屬性
    dp.setAuthor("Aspose.Slides for Android via 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 Android via Java 也允許開發人員為簡報文件屬性加入自訂值。以下範例示範如何為簡報設定自訂屬性。

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 Android via Java 亦允許開發人員存取自訂屬性的值。以下範例示範如何存取與修改簡報的所有自訂屬性。

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 簡報的自訂屬性。以下圖示分別顯示修改前後的簡報自訂屬性：

修改前的自訂屬性	**

修改後的自訂屬性	**

進階文件屬性

已在 IPresentationInfo 中加入新方法 ReadDocumentProperties、UpdateDocumentProperties、以及 WriteBindedPresentation ，且 IDocumentProperties.setLastSavedTime 屬性設定器的邏輯已變更。

這兩個新方法已加入至 [IPresentationInfo] 介面。它們提供快速存取文件屬性的能力，並允許在不載入完整簡報的情況下變更與更新屬性。

典型的情境是載入屬性、變更某些值，然後更新文件，可透過以下方式實作：

// 讀取簡報的資訊
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");

另一種方式是將特定簡報的屬性作為範本，以更新其他簡報的屬性：

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");

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 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");

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 提供 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("New Text");

    // 檢查第一個 portion 的語言
    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 方法即可有效讀取屬性，節省記憶體並提升效能。

在 Android 上的安全簡報在 Android 上檢索與更新簡報檢視屬性