在 Java 中管理脚本特定主题字体

本页内容简介

使用 Aspose.Slides for Java 检查、添加、替换和删除 PowerPoint 主题中的脚本特定字体映射。

概览

演示文稿主题可以为不同的书写系统选择不同的字体系列。这使得仍使用主题字体的多语言文本能够遵循统一的字体方案，同时为西里尔文、阿拉伯文、日文、格鲁吉亚文、塔纳文及其他文字使用合适的字体。

主题的IFontScheme包含一个主要字体集合，通常用于标题，以及一个次要字体集合，通常用于正文。除了它们的拉丁和东亚字体设置外，这两个集合还通过IFonts接口公开从书写系统标签到字体系列名称的映射。

本文展示了如何检查和修改演示文稿主主题中的这些映射，并验证更改在保存并重新加载的循环中仍然有效。

了解脚本标签

脚本字体方法使用四字母 BCP 47 脚本子标签来标识书写系统。常见的取值包括：

脚本标签	书写系统
`Cyrl`	西里尔文
`Arab`	阿拉伯文
`Hans`	简体中文
`Jpan`	日文
`Geor`	格鲁吉亚文
`Thaa`	塔纳文

这些映射属于主题字体方案，而不是单独的文本片段。演示文稿可以为主要和次要集合定义不同的映射，也可以省略某些脚本的映射。

访问并检查脚本字体映射

使用Presentation.getMasterTheme访问演示文稿级别的主题。IFontScheme.getMajor和IFontScheme.getMinor方法返回两个IFonts集合。

调用IFonts.getScriptFontMap可检索集合中的所有映射。要查找单个书写系统，请使用其脚本标签调用IFonts.getScriptFont。当该集合未定义请求的映射时，getScriptFont返回null。

修改映射并验证持久性

使用IFonts.setScriptFont可以创建映射或替换其当前字体系列。使用IFonts.removeScriptFont可以删除映射。

以下端到端示例读取所有现有的主要和次要映射，查找日语主要字体，更改西里尔文主要字体，删除塔纳文次要映射，保存演示文稿并重新打开以验证两项更改。为了使删除步骤不受初始主题影响，示例仅在未定义塔纳映射时才创建塔纳映射。

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中更改映射仅影响其有效格式仍依赖于该主题的内容。文本也可能从母版、布局或幻灯片继承主题覆盖，或使用显式分配的字体。当可见结果未遵循演示文稿级别的映射时，请检查这些层级。

使映射的字体可用并验证结果

脚本映射仅存储字体系列名称；它不安装或加载相应的字体文件。为保证渲染和导出的一致性，所有映射的字体必须在环境中安装，或通过自定义来源（如FontsLoader.loadExternalFonts或LoadOptions.getDocumentLevelFontSources）提供给 Aspose.Slides。请参阅Custom Fonts了解可用的加载选项。

验证已保存的映射仅确认主题定义被保留。它并不能证明该字体可用、包含所有必需的字形或产生预期的布局。将每个必需书写系统的代表性文本渲染为图像或 PDF 并检查输出。这可以在演示文稿分发前捕获缺失字体、字形覆盖不完整、回退行为以及布局变化。请参阅Convert PowerPoint Presentations了解渲染和导出示例。

常见问题

当脚本未映射时，getScriptFont 返回什么？

IFonts.getScriptFont在该主要或次要字体集合中未定义请求的脚本映射时返回null。

setScriptFont 在脚本已存在时会添加第二个映射吗？

不会。IFonts.setScriptFont在映射缺失时创建映射，在相同脚本标签已存在时替换已有的字体系列。

为什么更改主题映射未更改某些文本？

该文本可能已显式分配了字体，通过覆盖继承了不同的主题，或在渲染时受到替换或回退的影响。演示文稿级别的脚本映射仅控制其有效格式仍引用该主题字体集合的文本。

仅保存并重新打开是否足以验证多语言输出？

不是。重新打开仅验证主题数据的持久性。仍需渲染每个必需书写系统的代表性文本，以确认映射的字体可用且包含必要的字形。

在 Java 中管理演示文稿主题在 Java 中管理演示文稿背景