FontSubstitutionSettings

FontSubstitutionSettings class

Gibt die Einstellungen für den Mechanismus zur Schriftartersetzung an.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Schriftarten Dokumentationsartikel.

public class FontSubstitutionSettings

Eigenschaften

NameBeschreibung
DefaultFontSubstitution { get; }Einstellungen im Zusammenhang mit der Standardregel zur Schriftartersetzung.
FontConfigSubstitution { get; }Einstellungen im Zusammenhang mit der Schriftarten-Ersetzungsregel.
FontInfoSubstitution { get; }Einstellungen im Zusammenhang mit der Regel zur Ersetzung von Schriftinformationen.
FontNameSubstitution { get; }Einstellungen im Zusammenhang mit der Regel zur Ersetzung von Schriftnamen.
TableSubstitution { get; }Einstellungen im Zusammenhang mit der Tabellenersetzungsregel.

Bemerkungen

Der Schriftartersetzungsprozess besteht aus mehreren Regeln, die nacheinander in einer bestimmten Reihenfolge überprüft werden. Wenn die erste Regel die Schriftart nicht auflösen kann, wird die zweite Regel überprüft und so weiter.

Die Reihenfolge der Regeln ist folgende: 1. Regel zum Ersetzen von Schriftnamen (standardmäßig aktiviert) 2. Regel zum Ersetzen von Schriftkonfigurationen (standardmäßig deaktiviert) 3. Regel zum Ersetzen von Tabellen (standardmäßig aktiviert) 4. Regel zum Ersetzen von Schriftinformationen (standardmäßig aktiviert) 5. Regel für Standardschriftarten (standardmäßig aktiviert)

Beachten Sie, dass die Font-Info-Ersetzungsregel die Schriftart immer auflöst, wennFontInfo ist verfügbar und überschreibt die Standardschriftregel. Wenn Sie die Standardschriftregel verwenden möchten, deaktivieren Sie die Schriftinfo-Ersetzungsregel.

Beachten Sie, dass die Schriftart-Konfigurationsersetzungsregel die Schriftart in den meisten Fällen auflöst und somit alle anderen Regeln außer Kraft setzt.

Beispiele

Zeigt, wie Sie auf die Systemschriftartquelle eines Dokuments zugreifen und Schriftartenersatz festlegen.

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

// Standardmäßig enthält ein leeres Dokument immer eine Systemschriftartquelle.
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);
}

// Legen Sie eine Schriftart fest, die im Windows-Schriftartenverzeichnis als Ersatz für eine Schriftart vorhanden ist, die dort nicht vorhanden ist.
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());

// Alternativ könnten wir einen Ordner „Font Source“ hinzufügen, in dem der entsprechende Ordner die Schriftart enthält.
FolderFontSource folderFontSource = new FolderFontSource(FontsDir, false);
doc.FontSettings.SetFontsSources(new FontSourceBase[] {systemFontSource, folderFontSource});
Assert.AreEqual(2, doc.FontSettings.GetFontsSources().Length);

// Durch das Zurücksetzen der Schriftartquellen bleiben uns weiterhin die Systemschriftartquelle und unsere Ersatzschriften erhalten.
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());
Assert.True(doc.FontSettings.SubstitutionSettings.FontNameSubstitution.Enabled);

Siehe auch

FontSubstitutionRule Class MemoryFontSource Class