FontSubstitutionSettings

FontSubstitutionSettings class

Specifica le impostazioni del meccanismo di sostituzione dei caratteri.

Per saperne di più, visita ilLavorare con i caratteri articolo di documentazione.

public class FontSubstitutionSettings

Proprietà

NomeDescrizione
DefaultFontSubstitution { get; }Impostazioni relative alla regola di sostituzione dei caratteri predefinita.
FontConfigSubstitution { get; }Impostazioni relative alla regola di sostituzione della configurazione dei caratteri.
FontInfoSubstitution { get; }Impostazioni relative alla regola di sostituzione delle informazioni sui caratteri.
FontNameSubstitution { get; }Impostazioni relative alla regola di sostituzione del nome del carattere.
TableSubstitution { get; }Impostazioni relative alla regola di sostituzione della tabella.

Osservazioni

Il processo di sostituzione dei caratteri consiste in diverse regole che vengono controllate una per una in ordine specifico. Se la prima regola non riesce a risolvere il carattere, viene controllata la seconda regola e così via.

L’ordine delle regole è il seguente: 1. Regola di sostituzione del nome del carattere (abilitata per impostazione predefinita) 2. Regola di sostituzione della configurazione del carattere (disabilitata per impostazione predefinita) 3. Regola di sostituzione della tabella (abilitata per impostazione predefinita) 4. Regola di sostituzione delle informazioni sui caratteri (abilitato per impostazione predefinita) 5. Regola carattere predefinita (abilitato per impostazione predefinita)

Tieni presente che la regola di sostituzione delle informazioni sui caratteri risolverà sempre il carattere seFontInfo è disponibile e sovrascriverà la regola del carattere predefinita. Se desideri utilizzare la regola dei caratteri predefinita, dovresti disabilitare la regola di sostituzione delle informazioni sui caratteri .

Tieni presente che la regola di sostituzione della configurazione del carattere risolverà il carattere nella maggior parte dei casi e quindi sovrascrive tutte le altre regole.

Esempi

Mostra come accedere all’origine dei caratteri di sistema di un documento e impostare i sostituti dei caratteri.

Document doc = new Document();
doc.FontSettings = new FontSettings();

// Per impostazione predefinita, un documento vuoto contiene sempre un'origine carattere di sistema.
Assert.AreEqual(1, doc.FontSettings.GetFontsSources().Length);

SystemFontSource systemFontSource = (SystemFontSource) doc.FontSettings.GetFontsSources()[0];
Assert.AreEqual(FontSourceType.SystemFonts, systemFontSource.Type);
Assert.AreEqual(0, systemFontSource.Priority);

PlatformID pid = Environment.OSVersion.Platform;
bool isWindows = (pid == PlatformID.Win32NT) || (pid == PlatformID.Win32S) ||
                 (pid == PlatformID.Win32Windows) || (pid == PlatformID.WinCE);
if (isWindows)
{
    const string fontsPath = @"C:\WINDOWS\Fonts";
    Assert.AreEqual(fontsPath.ToLower(),
        SystemFontSource.GetSystemFontFolders().FirstOrDefault()?.ToLower());
}

foreach (string systemFontFolder in SystemFontSource.GetSystemFontFolders())
{
    Console.WriteLine(systemFontFolder);
}

// Imposta un carattere esistente nella directory Fonts di Windows come sostituto di uno che non esiste.
doc.FontSettings.SubstitutionSettings.FontInfoSubstitution.Enabled = true;
doc.FontSettings.SubstitutionSettings.TableSubstitution.AddSubstitutes("Kreon-Regular", new[] {"Calibri"});

Assert.AreEqual(1,
    doc.FontSettings.SubstitutionSettings.TableSubstitution.GetSubstitutes("Kreon-Regular").Count());
Assert.Contains("Calibri",
    doc.FontSettings.SubstitutionSettings.TableSubstitution.GetSubstitutes("Kreon-Regular").ToArray());

// In alternativa, potremmo aggiungere una cartella di origine del carattere in cui la cartella corrispondente contiene il carattere.
FolderFontSource folderFontSource = new FolderFontSource(FontsDir, false);
doc.FontSettings.SetFontsSources(new FontSourceBase[] {systemFontSource, folderFontSource});
Assert.AreEqual(2, doc.FontSettings.GetFontsSources().Length);

// Il ripristino delle fonti dei caratteri ci lascia ancora con la fonte dei caratteri di sistema e i nostri sostituti.
doc.FontSettings.ResetFontSources();

Assert.AreEqual(1, doc.FontSettings.GetFontsSources().Length);
Assert.AreEqual(FontSourceType.SystemFonts, doc.FontSettings.GetFontsSources()[0].Type);
Assert.AreEqual(1,
    doc.FontSettings.SubstitutionSettings.TableSubstitution.GetSubstitutes("Kreon-Regular").Count());

Guarda anche

FontSubstitutionRule Class MemoryFontSource Class