Konfigurera teckensnitt för rendering av kalkylblad med JavaScript via C++

Möjliga användningsscenario

Aspose.Cells API:er ger möjlighet att rendera kalkylblad i bildformat samt konvertera dem till PDF- och XPS-format. För att maximera konverteringskvaliteten är det nödvändigt att de teckensnitt som används i kalkylbladet finns tillgängliga i operativsystemets standardfontkatalog. Om de nödvändiga teckensnitten inte finns, kommer Aspose.Cells API:er att försöka ersätta de nödvändiga teckensnitten med de tillgängliga.

Val av teckensnitt

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

API försöker hitta teckensnitten på filsystemet som matchar det exakta teckensnittsnamnet som används i kalkylbladet.
Om API inte kan hitta teckensnitten med det exakta namnet försöker det använda standardteckensnittet som anges under arbetsbokens DefaultStyle.font egenskap.
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.
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.
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.
Slutligen, om API inte hittar några teckensnitt på filsystemet, renderar den kalkylbladet med Arial.

Ange anpassade typsnittsmappar

Aspose.Cells API söker i operativsystemets standardfontkatalog efter de nödvändiga teckensnitten. Om de inte finns där, söker API:erna i anpassade (användardefinierade) kataloger. Klassen FontConfigs har exponerat flera sätt att ange anpassade fontkataloger som beskrivs nedan.

FontConfigs.fontFolder(string, boolean): Metoden är användbar om det endast finns en mapp att ange.
**FontConfigs.fontFolders(string[], boolean)**: 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.
**FontConfigs.fontSources(FontSourceBase[])**: 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.fontFolder(string, boolean) och **FontConfigs.fontFolders(string[], boolean)** metoder accepterar en Boolean typ som andra parameter. Att passera true som andra parameter kommer att dirigera Aspose.Cells API:erna att söka igenom undermapparna efter teckensnittsfilerna.

<!DOCTYPE html>
<html>
    <head>
        <title>Aspose.Cells Font Configuration Example</title>
    </head>
    <body>
        <h1>Aspose.Cells Font Configuration Example</h1>
        <p>Select an Excel file (optional) and font resources to configure Aspose.Cells font sources in the browser.</p>

        <label>Excel File (optional):</label>
        <input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
        <br/><br/>

        <label>Font File (.ttf/.otf) (optional):</label>
        <input type="file" id="fontFileInput" accept=".ttf,.otf" />
        <br/><br/>

        <label>Font Folder (optional, select a folder):</label>
        <input type="file" id="fontFolderInput" webkitdirectory directory multiple />
        <br/><br/>

        <button id="runExample">Configure Fonts</button>
        <a id="downloadLink" style="display: none;">Download Result</a>
        <div id="result"></div>
    </body>

    <script src="aspose.cells.js.min.js"></script>
    <script type="text/javascript">
        const { Workbook, SaveFormat, Utils } = AsposeCells;

        AsposeCells.onReady({
            license: "/lic/aspose.cells.enc",
            fontPath: "/fonts/",
            fontList: [
                "arial.ttf",
                "NotoSansSC-Regular.ttf"
            ]
        }).then(() => {
            console.log("Aspose.Cells initialized");
        });

        document.getElementById('runExample').addEventListener('click', async () => {
            const fileInput = document.getElementById('fileInput');
            const fontFileInput = document.getElementById('fontFileInput');
            const fontFolderInput = document.getElementById('fontFolderInput');
            const resultDiv = document.getElementById('result');

            // Basic validation: ensure at least one font resource is provided (file or folder)
            if (!fontFileInput.files.length && !fontFolderInput.files.length) {
                resultDiv.innerHTML = '<p style="color: red;">Please select at least one font file or a font folder.</p>';
                return;
            }

            // Defining string variables to store paths/names to font folders & font file
            // (In browser environment we use simple names or uploaded file names)
            const fontFolder1 = "Arial";
            const fontFolder2 = "Calibri";
            const fontFile = "arial.ttf";

            // Setting first font folder (converted from setFontFolder)
            AsposeCells.FontConfigs.fontFolder = fontFolder1;
            // Preserve the subfolder-search flag from original API call as a separate property
            AsposeCells.FontConfigs.fontFolderSearchSubFolders = true;

            // Setting both font folders (converted from setFontFolders)
            AsposeCells.FontConfigs.fontFolders = [fontFolder1, fontFolder2];
            // Preserve the subfolder-search flag as a separate property
            AsposeCells.FontConfigs.fontFoldersSearchSubFolders = false;

            // Defining FolderFontSource
            const sourceFolder = new AsposeCells.FolderFontSource(fontFolder1, false);

            // Defining FileFontSource
            const sourceFile = new AsposeCells.FileFontSource(fontFile);

            // Defining MemoryFontSource
            let memoryFontBytes = new Uint8Array([]);
            if (fontFileInput.files.length) {
                const ff = fontFileInput.files[0];
                const arrayBuffer = await ff.arrayBuffer();
                memoryFontBytes = new Uint8Array(arrayBuffer);
            } else if (fontFolderInput.files.length) {
                // If a folder was provided, try to find a .ttf/.otf inside it and use the first found
                const files = Array.from(fontFolderInput.files);
                const fontCandidate = files.find(f => f.name.toLowerCase().endsWith('.ttf') || f.name.toLowerCase().endsWith('.otf'));
                if (fontCandidate) {
                    const arrayBuffer = await fontCandidate.arrayBuffer();
                    memoryFontBytes = new Uint8Array(arrayBuffer);
                }
            }
            const sourceMemory = new AsposeCells.MemoryFontSource(memoryFontBytes);

            // Setting font sources (converted from setFontSources)
            AsposeCells.FontConfigs.fontSources = [sourceFolder, sourceFile, sourceMemory];

            // Provide feedback to the user
            resultDiv.innerHTML = '<p style="color: green;">Font configuration applied successfully.</p>';
        });
    </script>
</html>

Använd gärna någon av ovan nämnda metoder i början av applikationen, det vill säga; innan du anropar några andra objekt i Aspose.Cells API:erna.

Om alla ovan nämnda metoder används för att ställa in teckensnittskällor, kommer endast de senaste inställningarna att träda i kraft.

Mekanism för typsnittsutbyte

Aspose.Cells API:er ger också möjlighet att specificera ersättningsteckensnitt för rendering. Denna mekanism är användbar när ett nödvändigt teckensnitt inte finns på maskinen där konverteringen sker. Användare kan ange en lista med teckensnittsnamn som ett alternativ till det ursprungliga nödvändiga teckensnittet. För att göra detta har Aspose.Cells API:er exponerat metoden **FontConfigs.fontSubstitutes(string, string[])** som tar emot 2 parametrar. Den första är av typen string, vilken är namnet på teckensnittet som ska ersättas. Den andra är en array av typen string, där användare kan ange en lista med teckensnittsnamn som ersättning för det ursprungliga teckensnittet (specificerat i den första parametern).

Här är ett enkelt användningsscenario.

<!DOCTYPE html>
<html>
    <head>
        <title>Aspose.Cells Example</title>
    </head>
    <body>
        <h1>Example Title</h1>
        <input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
        <button id="runExample">Run Example</button>
        <a id="downloadLink" style="display: none;">Download Result</a>
        <div id="result"></div>
    </body>

    <script src="aspose.cells.js.min.js"></script>
    <script type="text/javascript">
        const { Workbook, SaveFormat, Utils } = AsposeCells;

        AsposeCells.onReady({
            license: "/lic/aspose.cells.enc",
            fontPath: "/fonts/",
            fontList: [
                "arial.ttf",
                "NotoSansSC-Regular.ttf"
            ]
        }).then(() => {
            console.log("Aspose.Cells initialized");
        });

        document.getElementById('runExample').addEventListener('click', async () => {
            const fileInput = document.getElementById('fileInput');
            if (!fileInput.files.length) {
                document.getElementById('result').innerHTML = '<p style="color: red;">Please select an Excel file.</p>';
                return;
            }

            const file = fileInput.files[0];
            const arrayBuffer = await file.arrayBuffer();

            // Instantiating a Workbook object by opening the Excel file through the file stream
            const workbook = new Workbook(new Uint8Array(arrayBuffer));

            // Substituting the Arial font with Times New Roman & Calibri
            // Converted from: AsposeCells.FontConfigs.setFontSubstitutes("Arial", ["Times New Roman", "Calibri"]);
            AsposeCells.FontConfigs.fontSubstitutes = { "Arial": ["Times New Roman", "Calibri"] };

            // Saving the (possibly modified) workbook
            const outputData = workbook.save(SaveFormat.Xlsx);
            const blob = new Blob([outputData]);
            const downloadLink = document.getElementById('downloadLink');
            downloadLink.href = URL.createObjectURL(blob);
            downloadLink.download = 'output.xlsx';
            downloadLink.style.display = 'block';
            downloadLink.textContent = 'Download Excel File';

            document.getElementById('result').innerHTML = '<p style="color: green;">Operation completed successfully! Click the download link to get the processed file.</p>';
        });
    </script>
</html>

Informationssamling

Förutom ovan nämnda metoder har Aspose.Cells API:er även tillhandahållit möjligheter att samla information om vilka källor och ersättningar som har ställts in.

FontConfigs.fontSources metoden returnerar en array av typen FontSourceBase som innehåller listan över angivna fontkällor. Om inga källor har ställts in, returnerar metoden FontConfigs.fontSources en tom array.
FontConfigs.fontSubstitutes(string) metoden tar emot en parameter av typen string för att specificera teckensnittnamnet för vilket ersättning har ställts in. Om ingen ersättning har ställts in för det angivna teckensnittet, returnerar metod FontConfigs.fontSubstitutes(string) null.

Fortsatta ämnen

Specifiera individuella eller privata teckensätt för arbetsbokens rendering med JavaScript via C++