Konfigurera teckensnitt för rendering av kalkylblad

Möjliga användningsscenario

Aspose.Cells API: er tillhandahåller möjlighet att rendera kalkylbladen i bildformat samt konvertera dem till PDF- och XPS-format. För att maximera konversionsfideliteten är det nödvändigt att teckensnitten som används i kalkylbladet bör finnas i operativsystemets standardteckensnittkatalog. Om de nödvändiga teckensnitten inte är närvarande kommer Aspose.Cells API: er att försöka ersätta de nödvändiga teckensnitten med de som finns tillgängliga.

Val av teckensnitt

Nedan är processen som Aspose.Cells API: er följer bakom scenen.

1. API försöker hitta teckensnitten på filsystemet som matchar det exakta teckensnittsnamnet som används i kalkylbladet.
2. Om API inte kan hitta teckensnitten med det exakta namnet försöker det använda standardteckensnittet som anges under arbetsbokens DefaultStyle.Font egenskap.
3. Om API inte kan hitta teckensnittet som definieras under arbetsbokens DefaultStyle.Font egenskap försöker det använda teckensnittet som anges under PdfSaveOptions.DefaultFont eller ImageOrPrintOptions.DefaultFont egenskap.
4. Om API inte kan hitta teckensnittet som definieras under PdfSaveOptions.DefaultFont eller ImageOrPrintOptions.DefaultFont egenskap försöker den använda teckensnittet som anges under FontConfigs.DefaultFontName egenskap.
5. Om API inte kan hitta teckensnittet som definieras under FontConfigs.DefaultFontName egenskapen försöker det välja de mest lämpliga teckensnitten från alla tillgängliga teckensnitt.
6. Slutligen, om API inte hittar några teckensnitt på filsystemet, renderar den kalkylbladet med Arial.

Aspose.Cells API: er skannar alltid operativsystemets standardteckensnittskatalog med ett undantag, det vill säga när JVM-argument -DAspose.Cells.FontDirExc = “YourFontDir” är inställda. I det fallet kommer Aspose.Cells API: er att hoppa över att skanna operativsystemets standardteckensnittskatalog och bara söka sökvägen som specificeras i ovan nämnda JVM-argument.

Ange anpassade typsnittsmappar

Aspose.Cells API:er söker efter de nödvändiga typsnitten i operativsystemets standardtypsnittsmapp. Om de nödvändiga typsnitten inte finns i systemets typsnittsmapp, söker API:erna genom de användardefinierade (anpassade) mapparna. FontConfigs klassen har specificerat ett flertal sätt att ange anpassade typsnittsmappar enligt följande detaljerat.

1. FontConfigs.setFontFolder: Metoden är användbar om det endast finns en mapp att ange.
2. FontConfigs.setFontFolders: Metoden är användbar när typsnitten finns i flera mappar och användaren vill ange alla mapparna separat istället för att kombinera alla typsnitt i en enda mapp.
3. FontConfigs.setFontSources: Mekanismen är användbar när användaren vill ladda typsnitt från flera mappar eller en enda typsnittsfil eller typsnittsdata från en byte-array.

Både FontConfigs.setFontFolder och FontConfigs.setFontFolders metoder accepterar en parameter av typen boolean. Om sann (true) anges som andra parameter kommer Aspose.Cells API:erna att söka efter undermappar efter typsnittsfiler.

Var god använd någon av de ovan nämnda metoderna i starten av programmet, dvs innan några objekt från Aspose.Cells API:erna anropas.

Om fler än en av de ovan nämnda metoderna används för att ange typsnittskällor kommer endast de senaste inställningarna att ha effekt.

Mekanism för typsnittsutbyte

Aspose.Cells API:erna ger också möjlighet att ange ersättningstypsnitt för presentationssyfte. Detta mekanism är användbar när ett nödvändigt typsnitt inte är tillgängligt på den maskin där konvertering ska ske. Användare kan ange en lista med typsnittsnamn som alternativ till det ursprungliga typsnittet. Aspose.Cells API:erna har exponerat metoden FontConfigs.setFontSubstitutes som accepterar två parametrar. Den första parametern är av typen String och ska vara namnet på det typsnitt som ska ersättas. Den andra parametern är en array av typen String. Användare kan ange en lista med typsnittsnamn som ersättningar för det ursprungliga typsnittet (specificerat i den första parametern).

Här är ett enkelt användningsscenario.

 //Substituting the Arial font with Times New Roman & Calibri

FontConfigs.setFontSubstitutes("Arial", new String[] { "Times New Roman", "Calibri" });

Informationssamling

Förutom de ovan nämnda metoderna har Aspose.Cells API:erna även medel för att samla information om vilka källor och ersättningar som har angetts.

1. FontConfigs.getFontSources: Denna metod returnerar en array av typen FontSourceBase innehållande listan över specificerade typsnittskällor. Om ingen källa har angetts returnerar metoden FontConfigs.getFontSources en tom array.
2. FontConfigs.getFontSubstitutes: Denna metod accepterar en parameter av typen String som låter användaren ange typsnittsnamnet för vilket ersättning har angetts. Om ingen ersättning har angetts för det angivna typsnittsnamnet returnerar metoden FontConfigs.getFontSubstitutes null.