Textumriss-Effekt zu Text hinzufügen

This article was translated from English: Does it need improvement?
Translated
View the article in English

Ein Textumrandungseffekt fügt einen sichtbaren Rahmen um die Zeichen des Textes hinzu und schafft so eine definierte Umrandung, die die Lesbarkeit oder die visuelle Wirkung verbessert. Dieser Effekt kann in Bezug auf Farbe, Dicke und Stil an die jeweiligen Designvorlieben angepasst werden. Sie wird häufig in Grafik, Typografie und digitalem Design verwendet, um Text von Hintergründen abzuheben oder ein stilisiertes Erscheinungsbild zu schaffen.

Erste Schritte mit IronWord

Beginnen Sie noch heute mit der Verwendung von IronWord in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:
green arrow pointer


Textkontureffekt hinzufügen

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

: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");
Imports IronWord
Imports IronWord.Models

' Create new Word document
Private doc As New WordDocument()

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {.TextOutlineEffect = TextOutlineEffect.DefaultEffect}

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

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")
VB   C#
Textumriss-Effekt hinzufügen

Eigenschaften des Textumriss-Effekts

Der Textumriss-Effekt bietet eine Vielzahl von anpassbaren Eigenschaften, die sich an jeden Gestaltungswunsch anpassen lassen. Nachfolgend finden Sie die Objekte mit ihren Beschreibungen:

  • PenAlignment: Liest oder setzt die Ausrichtung des Stifts, der für den Kontureffekt verwendet wird.
  • LineCapType: Liest oder setzt den Typ der Linienkappe, die für den Kontureffekt verwendet wird.
  • LineWidth: Liest oder setzt die Breite der Kontureffektlinie.(Bemerkung: Die Breite wird in Punkten angegeben(1/72 Zoll).)
  • CompoundLineType: Liest oder setzt den Typ der zusammengesetzten Linie, die für den Umriss-Effekt verwendet wird.
  • LineJoin: Liest oder setzt den Stil der Linienverbindung, der für den Umrisseffekt verwendet wird.
  • Farbe: Liest oder setzt die Farbe der Füllung für den Umriss-Effekt.
  • presetLineDash: Liest oder setzt den voreingestellten Linienstrich-Stil für den Umriss-Effekt.
: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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Private doc As New WordDocument()

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
	.TextOutlineEffect = New TextOutlineEffect() With {
		.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")
VB   C#
Benutzerdefinierter Textumriss-Effekt