管理 Java 中的腳本特定主題字體

本頁內容簡介

檢查、添加、取代以及移除 PowerPoint 主題中的腳本特定字體對映，使用 Aspose.Slides for Java。

概述

簡報主題可以為不同的書寫系統選擇不同的字族。這使得仍使用主題字體的多語言文字在使用西里爾文、阿拉伯文、日文、喬治亞文、Thaana 等文字時，仍能遵循同一套協調的字體方案，且使用適合該腳本的字體。

主題的IFontScheme包含主要字體集合，通常用於標題，以及次要字體集合，通常用於正文。除了它們的拉丁字與東亞字設定外，兩個集合皆透過IFonts介面提供從書寫系統標籤到字族名稱的對映。

本文示範如何檢查與修改簡報主題中的這些對映，並驗證變更在儲存與重新載入的週期中得以保留。

了解腳本標籤

腳本字體方法使用四個字母的 BCP 47 腳本子標籤來識別書寫系統。常見值包括：

腳本標籤	書寫系統
Cyrl	西里爾文
Arab	阿拉伯文
Hans	簡體中文
Jpan	日文
Geor	喬治亞文
Thaa	Thaana

這些對映屬於主題字體方案，而非個別文字片段。簡報可以為主要與次要集合定義不同的對映，也可以對某些腳本省略對映。

存取與檢查腳本字體對映

使用Presentation.getMasterTheme存取簡報層級的主題。
IFontScheme.getMajor與IFontScheme.getMinor方法會回傳兩個IFonts集合。

呼叫IFonts.getScriptFontMap以取得集合中所有的對映。若要查詢單一書寫系統，使用IFonts.getScriptFont並傳入其腳本標籤。當該集合未定義請求的對映時，getScriptFont 會回傳 null。

修改對映並驗證持久性

使用IFonts.setScriptFont建立對映或取代目前的字族。使用IFonts.removeScriptFont則可移除對映。

以下端對端範例會讀取所有現有的主要與次要對映、查詢日文主要字體、變更西里爾文主要字體、移除 Thaana 次要對映、儲存簡報，並重新開啟以驗證兩項變更。為了讓移除步驟不受初始主題影響，範例會在未先前定義 Thaana 對映時才建立該對映。

import com.aspose.slides.*;
import com.aspose.slides.Collections.Generic.Dictionary;
import com.aspose.slides.Collections.Generic.KeyValuePair;

Presentation presentation = new Presentation();
try {
    IFontScheme fontScheme = presentation.getMasterTheme().getFontScheme();
    IFonts majorFonts = fontScheme.getMajor();
    IFonts minorFonts = fontScheme.getMinor();

    System.out.println("Existing major mappings:");
    Dictionary.Enumerator<String, String> majorMappings = majorFonts.getScriptFontMap().iterator();
    while (majorMappings.hasNext()) {
        KeyValuePair<String, String> mapping = majorMappings.next();
        System.out.println("  " + mapping.getKey() + ": " + mapping.getValue());
    }

    System.out.println("Existing minor mappings:");
    Dictionary.Enumerator<String, String> minorMappings = minorFonts.getScriptFontMap().iterator();
    while (minorMappings.hasNext()) {
        KeyValuePair<String, String> mapping = minorMappings.next();
        System.out.println("  " + mapping.getKey() + ": " + mapping.getValue());
    }

    String japaneseFont = majorFonts.getScriptFont("Jpan");
    if (japaneseFont == null) {
        System.out.println("No major Japanese font is defined.");
    } else {
        System.out.println("Major Japanese font: " + japaneseFont);
    }

    majorFonts.setScriptFont("Cyrl", "Arial");

    if (minorFonts.getScriptFont("Thaa") == null) {
        minorFonts.setScriptFont("Thaa", "Arial");
    }

    minorFonts.removeScriptFont("Thaa");
    presentation.save("script-font-mappings.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Presentation savedPresentation = new Presentation("script-font-mappings.pptx");
try {
    IFonts savedMajorFonts = savedPresentation.getMasterTheme().getFontScheme().getMajor();
    IFonts savedMinorFonts = savedPresentation.getMasterTheme().getFontScheme().getMinor();
    String savedCyrillicFont = savedMajorFonts.getScriptFont("Cyrl");
    String savedThaanaFont = savedMinorFonts.getScriptFont("Thaa");

    if ("Arial".equals(savedCyrillicFont)) {
        System.out.println("The Cyrillic mapping was preserved.");
    } else {
        System.out.println("The Cyrillic mapping was not preserved.");
    }

    if (savedThaanaFont == null) {
        System.out.println("The Thaana mapping removal was preserved.");
    } else {
        System.out.println("The Thaana mapping still exists.");
    }
} finally {
    savedPresentation.dispose();
}

驗證使用與普通查詢相同的 null 行為：在移除後儲存，getScriptFont("Thaa") 於次要集合會回傳 null。

將主題對映與其他字體設定區分開來

腳本特定的主題對映會參與字體選擇，但它解決的問題不同於直接的文字格式設定、替換與回退：

機制	目的	變更主題對映的效果
腳本特定的主題字體對映	為特定書寫系統選取主要或次要主題字體。	仍使用相應主題字體的文字會依新對映的字族解析。
明確指派給文字片段的字體	在該片段上固定請求的字族，而不依賴主題。	由於直接格式覆蓋主題選擇，文字可能保持不變。
字體替換	當請求的字體不存在或符合替換規則時，取代該字體。	替換發生在字體已被請求之後；不會重新定義主題的腳本對映。
字體回退	為所選字體未涵蓋的字形（常見於特定 Unicode 範圍）提供替代字形。	填補缺失的字形，並不會改變已儲存的主題對映。

欲取得關於最後兩種機制的更多資訊，請參閱Font Substitution與Fallback Fonts。

變更Presentation.getMasterTheme 中的對映僅影響仍依賴該主題的有效格式內容。文字也可能從母版、佈局或投影片繼承主題覆寫，或使用明確指派的字體。當可見結果未遵循簡報層級的對映時，請檢查這些層級。

使對映字體可用並驗證結果

腳本對映僅儲存字族名稱；它不會安裝或載入對應的字體檔。為了獲得一致的渲染與匯出，所有對映的字體必須安裝在執行環境中，或透過自訂來源提供給 Aspose.Slides，例如FontsLoader.loadExternalFonts或LoadOptions.getDocumentLevelFontSources。請參閱Custom Fonts了解可用的載入選項。

驗證已儲存的對映僅能確認主題定義已被保留，並不代表字體已安裝、包含所有必要字形，或產生預期的版面配置。請將每個必需書寫系統的代表性文字渲染為圖像或 PDF，並檢查輸出。此步驟可捕捉缺少字體、字形覆蓋不完整、回退行為與版面變更，避免在簡報發佈前發生問題。相關渲染與匯出範例請參閱Convert PowerPoint Presentations。

常見問題

當腳本未被對映時，getScriptFont 會回傳什麼？

IFonts.getScriptFont 於該主要或次要字體集合未定義請求的腳本對映時，回傳 null。

setScriptFont 會在腳本已存在時新增第二筆對映嗎？

不會。IFonts.setScriptFont 只會在缺少對映時建立，若相同腳本標籤已存在則會取代原有的字族。

為什麼變更主題對映後，有些文字並未改變？

該文字可能已明確指派字體、透過覆寫繼承了不同的主題，或在渲染時受到替換或回退的影響。簡報層級的腳本對映僅控制仍依賴該主題字體集合的文字。

儲存並重新開啟就能驗證多語言輸出嗎？

不能。重新開啟只能驗證主題資料的持久性。仍需渲染每個必需書寫系統的代表性文字，以確認對映的字體可用且包含必要字形。