TableSubstitutionRule

TableSubstitutionRule class

Regola di sostituzione dei caratteri della tabella.

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

public class TableSubstitutionRule : FontSubstitutionRule

Proprietà

NomeDescrizione
virtual Enabled { get; set; }Specifica se la regola è abilitata o meno.

Metodi

NomeDescrizione
AddSubstitutes(string, params string[])Aggiunge nomi di font sostitutivi per il nome del font originale specificato.
GetSubstitutes(string)Restituisce l’array contenente i nomi dei font sostitutivi per il nome del font originale specificato.
Load(Stream)Carica le impostazioni di sostituzione della tabella dal flusso XML.
Load(string)Carica le impostazioni di sostituzione della tabella dal file XML.
LoadAndroidSettings()Carica le impostazioni di sostituzione della tabella predefinite per la piattaforma Android.
LoadLinuxSettings()Carica le impostazioni di sostituzione della tabella predefinite per la piattaforma Linux.
LoadWindowsSettings()Carica le impostazioni di sostituzione della tabella predefinite per la piattaforma Windows.
Save(Stream)Salva le impostazioni di sostituzione della tabella correnti nello streaming.
Save(string)Salva le impostazioni di sostituzione della tabella correnti nel file.
SetSubstitutes(string, params string[])Sostituisci i nomi dei caratteri sostitutivi per il nome del carattere originale specificato.

Osservazioni

Questa regola definisce l’elenco dei nomi dei font sostitutivi da utilizzare se il font originale non è disponibile. Verranno controllati i sostituti per il nome del font e ilAltName (se presente).

Esempi

Mostra come accedere alle tabelle di sostituzione dei caratteri per Windows e Linux.

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

// Crea una nuova regola di sostituzione della tabella e carica la tabella di sostituzione dei caratteri predefinita di Microsoft Windows.
TableSubstitutionRule tableSubstitutionRule = fontSettings.SubstitutionSettings.TableSubstitution;
tableSubstitutionRule.LoadWindowsSettings();

// In Windows, il sostituto predefinito del carattere "Times New Roman CE" è "Times New Roman".
Assert.AreEqual(new[] {"Times New Roman"},
    tableSubstitutionRule.GetSubstitutes("Times New Roman CE").ToArray());

// Possiamo salvare la tabella sotto forma di documento XML.
tableSubstitutionRule.Save(ArtifactsDir + "FontSettings.TableSubstitutionRule.Windows.xml");

// Linux ha la propria tabella di sostituzione.
// Esistono più caratteri sostitutivi per "Times New Roman CE".
// Se anche il primo sostituto, "FreeSerif", non è disponibile,
// questa regola scorrerà le altre nell'array finché non ne troverà una disponibile.
tableSubstitutionRule.LoadLinuxSettings();
Assert.AreEqual(new[] {"FreeSerif", "Liberation Serif", "DejaVu Serif"},
    tableSubstitutionRule.GetSubstitutes("Times New Roman CE").ToArray());

// Salva la tabella di sostituzione Linux sotto forma di documento XML utilizzando uno stream.
using (FileStream fileStream = new FileStream(ArtifactsDir + "FontSettings.TableSubstitutionRule.Linux.xml",
    FileMode.Create))
{
    tableSubstitutionRule.Save(fileStream);
}

Guarda anche