Beheer script-specifieke themalettertypen in Java

Waar deze pagina over gaat

Inspecteer, voeg toe, vervang en verwijder script-specifieke lettertype-mappings in PowerPoint-thema’s met Aspose.Slides voor Java.

Overzicht

Een presentatiethema kan verschillende lettertypefamilies selecteren voor verschillende schriftssystemen. Dit maakt het mogelijk om meertalige tekst die nog steeds thema‑lettertypen gebruikt, één gecoördineerd lettertype‑schema te laten volgen, terwijl geschikte lettertypen voor Cyrillisch, Arabisch, Japans, Georgisch, Thaana en andere schriften worden gebruikt.

Het thema‑IFontScheme bevat een hoofd‑lettertypeverzameling, doorgaans gebruikt voor koppen, en een secundaire lettertypeverzameling, doorgaans gebruikt voor de lopende tekst. Naast hun Latijnse en Oost‑Aziatische lettertype‑instellingen, bieden beide verzamelingen mappings van schrijfsysteem‑tags naar lettertype‑familienamen via de IFonts interface.

Dit artikel laat zien hoe u die mappings in het master‑thema van de presentatie kunt inspecteren en aanpassen, en hoe u kunt verifiëren dat de wijzigingen een opslaan‑en‑herladen‑cyclus overleven.

Begrijpen van script‑tags

De script‑lettertype‑methoden gebruiken vierletterige BCP 47 script‑subtags om schriftssystemen te identificeren. Veelvoorkomende waarden zijn:

Script‑tag	Schriftsysteem
`Cyrl`	Cyrillisch
`Arab`	Arabisch
`Hans`	Vereenvoudigd Chinees
`Jpan`	Japans
`Geor`	Georgisch
`Thaa`	Thaana

Deze mappings behoren tot het thematische lettertype‑schema, niet tot individuele tekstgedeelten. Een presentatie kan verschillende mappings definiëren voor de hoofd‑ en secundaire verzamelingen, en kan mappings voor sommige scripts weglaten.

Toegang tot en inspectie van script‑lettertype‑mappings

Gebruik Presentation.getMasterTheme om toegang te krijgen tot het thema op presentatieniveau. De methoden IFontScheme.getMajor en IFontScheme.getMinor geven de twee IFonts‑verzamelingen terug.

Roep IFonts.getScriptFontMap aan om alle mappings uit een verzameling op te halen. Om een specifiek schriftssysteem op te zoeken, roep je IFonts.getScriptFont aan met de bijbehorende script‑tag. getScriptFont retourneert null wanneer die verzameling de gevraagde mapping niet definieert.

Mappings wijzigen en persistentie verifiëren

Gebruik IFonts.setScriptFont om een mapping te maken of de huidige lettertype‑familie te vervangen. Gebruik IFonts.removeScriptFont om een mapping te verwijderen.

Het volgende end‑to‑end voorbeeld leest alle bestaande hoofd‑ en secundaire mappings, zoekt het Japanse hoofd‑lettertype op, wijzigt het Cyrillische hoofd‑lettertype, verwijdert de Thaana‑secundaire mapping, slaat de presentatie op en opent deze opnieuw om beide wijzigingen te verifiëren. Om de verwijderingsstap onafhankelijk te maken van het oorspronkelijke thema, maakt het voorbeeld eerst een Thaana‑mapping aan alleen als er nog geen bestaat.

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();
}

De verificatie gebruikt hetzelfde null‑gedrag als een gewone lookup: na het opslaan van de verwijdering retourneert getScriptFont("Thaa") null voor de secundaire verzameling.

Verschil tussen themamappings en andere lettertype‑instellingen

Script‑specifieke themamappings nemen deel aan de lettertype‑selectie, maar lossen een ander probleem op dan directe tekstopmaak, substitutie en fallback:

Mechanisme	Doel	Effect van het wijzigen van een themamapping
Script‑specifieke themalettertype‑mapping	Selecteert een hoofd‑ of secundair themalettertype voor een schriftssysteem.	Tekst die nog steeds het overeenkomstige themalettertype gebruikt, kan zich verplaatsen naar de nieuw gemapte familie.
Lettertype expliciet toegewezen aan een tekstgedeelte	Bepaalt de gevraagde lettertype‑familie voor dat gedeelte in plaats van te vertrouwen op het thema.	Het gedeelte kan ongewijzigd blijven omdat de directe opmaak de themakeuze overschrijft.
Lettertype‑substitutie	Vervangt een gevraagd lettertype wanneer dat lettertype niet beschikbaar is of wanneer een substitutieregel van toepassing is.	Het treedt op nadat een lettertype is aangevraagd; het herschrijft de script‑mapping van het thema niet.
Lettertype‑fallback	Levert tekens die het geselecteerde lettertype niet bevat, vaak voor specifieke Unicode‑bereiken.	Het vult ontbrekende tekens aan; het wijzigt de opgeslagen themamapping niet.

Voor meer informatie over de laatste twee mechanismen, zie Lettertype‑substitutie en Fallback‑lettertypen.

Het wijzigen van een mapping in Presentation.getMasterTheme beïnvloedt alleen inhoud waarvan de effectieve opmaak nog steeds afhankelijk is van dat thema. Tekst kan in plaats daarvan een themabijschrijving erven van een master, lay‑out of dia, of een expliciet toegewezen lettertype gebruiken. Inspecteer die niveaus wanneer het zichtbare resultaat niet overeenkomt met de mapping op presentatieniveau.

Gemapte lettertypen beschikbaar maken en het resultaat valideren

Een script‑mapping slaat een lettertype‑familienaam op; hij installeert of laadt het bijbehorende lettertype‑bestand niet. Voor consistente weergave en export moet elk gemapt lettertype geïnstalleerd zijn in de omgeving of beschikbaar worden gesteld aan Aspose.Slides via een aangepaste bron zoals FontsLoader.loadExternalFonts of LoadOptions.getDocumentLevelFontSources. Zie Aangepaste lettertypen voor de beschikbare laadopties.

Het verifiëren van de opgeslagen mapping bevestigt alleen dat de themadefinitie behouden bleef. Het bewijst niet dat het lettertype beschikbaar is, alle vereiste tekens bevat, of de beoogde lay‑out oplevert. Render representatieve tekst voor elk vereist schriftssysteem naar een afbeelding of PDF en inspecteer de uitvoer. Hiermee worden ontbrekende lettertypen, onvolledige teken‑dekking, fallback‑gedrag en lay‑outwijzigingen opgespoord voordat de presentatie wordt verspreid. Zie PowerPoint‑presentaties converteren voor voorbeelden van weergave en export.

FAQ

Wat retourneert getScriptFont wanneer een script niet gemapt is?

[IFonts.getScriptFont](https://reference.aspose.com/slides/nl/java/com.aspose.slides/fonts/#getScriptFont-java.lang.String-) retourneert null wanneer de gevraagde script‑mapping niet is gedefinieerd in die hoofd‑ of secundaire lettertype‑verzameling.

Voegt setScriptFont een tweede mapping toe wanneer het script al bestaat?

Nee. [IFonts.setScriptFont](https://reference.aspose.com/slides/nl/java/com.aspose.slides/fonts/#setScriptFont-java.lang.String-java.lang.String-) maakt de mapping aan wanneer deze ontbreekt en vervangt de gemapte lettertype‑familie wanneer dezelfde script‑tag al aanwezig is.

Waarom wijzigde het aanpassen van een themamapping niet sommige tekst?

De tekst kan een expliciet toegewezen lettertype hebben, een ander thema erven via een overschrijving, of beïnvloed worden door substitutie of fallback tijdens het renderen. Een script‑mapping op presentatieniveau regelt alleen tekst waarvan de effectieve opmaak nog steeds verwijst naar die themalettertype‑verzameling.

Is opslaan en opnieuw openen voldoende om meertalige output te valideren?

Nee. Het opnieuw openen verifieert alleen de persistentie van de themagegevens. Render bovendien representatieve tekst uit elk vereist schriftssysteem om te bevestigen dat de gemapte lettertypen beschikbaar zijn en de benodigde tekens bevatten.

Beheer presentatiethema’s in Java Beheer presentatie‑achtergronden in Java