Hinzufügen eines Textumriss-Effekts in C#

Warum sollte ich TextOutlineEffect für die Textgestaltung verwenden?

Um den Textumrisseffekt für den Text anzugeben, erstellen Sie das Objekt TextStyle und füllen Sie die Eigenschaft TextOutlineEffect mit einem TextOutlineEffect-Objekt aus. Fügen Sie schließlich neuen Text mit dem Stil hinzu, indem Sie das TextStyle-Objekt der TextEffect-Eigenschaft zuweisen.

Die Klasse TextOutlineEffect bietet eine umfassende API zur Steuerung aller Aspekte Ihrer Textumrisse. Im Gegensatz zu den grundlegenden Textformatierungsoptionen bietet es eine granulare Steuerung der Umrisseigenschaften wie Linienbreite, Farbe, Stiftausrichtung und Strichmuster. Dieses Maß an Kontrolle ist bei der Erstellung professioneller Dokumente, die bestimmten Markenrichtlinien oder Anforderungen an die Barrierefreiheit genügen müssen, unerlässlich.

Bei Geschäftsanwendungen können Textumrisse die Lesbarkeit von Dokumenten erheblich verbessern, wenn diese auf verschiedenen Papiersorten gedruckt oder auf verschiedenen Geräten angezeigt werden sollen. Die Gliederung schafft eine Pufferzone um jedes Zeichen, so dass der Text auch vor unruhigen Hintergründen oder in kontrastarmen Szenarien lesbar bleibt.

Was ist das grundlegende Code-Muster für das Hinzufügen von Gliederungen?

:path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-effect.cs

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

Dieses grundlegende Muster demonstriert den grundlegenden Ansatz für die Anwendung von Textumrissen. Der Code erstellt ein neues Dokument, definiert einen Textstil mit dem Standardumriss-Effekt, wendet ihn auf den Text an und speichert das Ergebnis. Der DefaultEffect bietet eine ausgewogene Gliederung, die für die meisten Szenarien gut geeignet ist. Er zeichnet sich durch eine dezente Breite und eine komplementäre Farbe aus, die den Text hervorhebt, anstatt ihn zu überlagern.

Welche Eigenschaften steuern das Erscheinungsbild der Gliederung?

Der Textumrisseffekt bietet eine Vielzahl anpassbarer Eigenschaften, die jedem Designbedarf entsprechen. Wenn Sie diese Eigenschaften verstehen, können Sie Gliederungen erstellen, die perfekt zu den visuellen Anforderungen und Markenrichtlinien Ihres Dokuments passen. Unten sind die Eigenschaften zusammen mit ihren Beschreibungen aufgeführt:

Jede Eigenschaft dient einem bestimmten Zweck bei der Erstellung professionell aussehender Textumrisse. Die Linienbreite wirkt sich beispielsweise direkt auf die visuelle Hervorhebung aus - dünnere Umrisse (0,1-0,3 Punkte) erzeugen eine subtile Betonung, während dickere Umrisse (1,0-2,0 Punkte) fette Aussagen machen. Die Eigenschaft Farbe ist entscheidend für die Wahrung der Markenkonsistenz und die Gewährleistung eines angemessenen Kontrasts für die Barrierefreiheit.

Wie wende ich benutzerdefinierte Gliederungseigenschaften an?

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

// Add text with style
doc.AddText("Customized text outline").Style = textStyle;

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");

Dieses fortgeschrittene Beispiel zeigt die volle Leistungsfähigkeit der benutzerdefinierten Gliederungskonfiguration. Der Code erzeugt einen markanten roten Umriss mit einem Doppellinienstil, der zeigt, wie mehrere Eigenschaften zusammenwirken, um bestimmte visuelle Effekte zu erzielen. Die runden Linienkappen und die schrägen Verbindungen erzeugen glatte, professionell wirkende Konturen, die sich gut für Überschriften und Titel eignen.

Wenn Sie benutzerdefinierte Gliederungen in Produktionsanwendungen implementieren, sollten Sie wiederverwendbare Stilvorlagen erstellen. Definieren Sie Standard-Gliederungskonfigurationen für verschiedene Dokumentelemente (Überschriften, Zwischenüberschriften, Hervorhebungen) und speichern Sie diese als Konstanten oder Konfigurationseinstellungen. Dieser Ansatz gewährleistet Konsistenz in Ihrer gesamten Dokumentenerstellungspipeline und vereinfacht die Pflege, wenn sich die Markenrichtlinien ändern.

Um optimale Ergebnisse zu erzielen, sollten Sie Ihre Gliederungseffekte in verschiedenen Ausgabeformaten und unter verschiedenen Anzeigebedingungen testen. Was auf dem Bildschirm gut aussieht, muss möglicherweise für die Druckausgabe angepasst werden. Berücksichtigen Sie bei der Auswahl von Konturbreiten und Farben Faktoren wie Druckerauflösung, Papierfarbe und Betrachtungsabstand. Die Flexibilität der Klasse TextOutlineEffect von IronWord ermöglicht eine programmatische Feinabstimmung dieser Parameter auf der Grundlage der Ausgabeanforderungen.