Textumriss hinzufügen

VBC#

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,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

Imports IronWord
Imports IronWord.Models

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

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

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Hello World"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

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

PM > Install-Package IronWord

Install-Package IronWord

Textumriss hinzufügen

Hinzufügen von Textkontureffekten

Textumrisseffekte verbessern die Lesbarkeit und den Stil des Textes, indem sie um jedes Zeichen einen Rahmen zeichnen. Dieser Effekt eignet sich besonders gut, um auffällige, markante Texte zu erstellen oder die Lesbarkeit zu gewährleisten, wenn der Text über Bildern oder farbigen Hintergründen erscheint. IronWord bietet die TextOutlineEffect Klasse mit voreingestellten Konfigurationen für eine schnelle Implementierung.

Um eine Textumrandung anzuwenden, erstellen Sie ein TextStyle Objekt und konfigurieren dessen TextEffect Eigenschaft mit TextOutlineEffect.DefaultEffect. Diese Voreinstellung bietet eine Standardkonfiguration, die für die meisten Anwendungsfälle gut geeignet ist. Bei benutzerdefinierten Konturen können Entwickler Eigenschaften wie Konturbreite, Farbe und Linienstil festlegen, um bestimmte visuelle Effekte zu erzielen.

Nach der Einrichtung des Textstils erstellen Sie ein Run, das den gewünschten TextContent enthält, und weisen den konfigurierten Stil der Style Eigenschaft der Ausführung zu. Verwenden Sie AddChild, um die gestaltete Ausführung einem Absatz hinzuzufügen, und fügen Sie anschließend den Absatz dem Dokument hinzu. Dieser strukturierte Ansatz gewährleistet die korrekte Formatierung und die Integrität des Dokuments.

Code Erklärung

Das Anwenden eines Textumrisses auf Text ist mit IronWord super einfach. Trotz seiner Einfachheit kann jedes Attribut des Textumrisses so angepasst werden, dass es jedem Bedarf entspricht. Sobald ein Word-Dokument importiert ist, wird die textStyle so konfiguriert, dass ein Textumrandungseffekt enthalten ist, indem der TextOutlineEffect.DefaultEffect der TextOutlineEffect Eigenschaft einer neuen TextEffect Instanz zugewiesen wird.

Um diesen Effekt auf Text anzuwenden, wird ein Paragraph erstellt und dann ein Run Objekt erstellt, das den gewünschten TextContent enthält. Die konfigurierte textStyle wird der Run zugewiesen und der Texteffekt wird angewendet. Die Run wird mit AddChild dem Paragraph hinzugefügt, und die Paragraph wird dem Dokument hinzugefügt. Dies folgt der Dokumenthierarchie: Dokument → Absatz → Textabschnitt → Textinhalt. Schließlich wird das Dokument exportiert.

Erfahren Sie mehr über Dokumentelemente mit IronWord.

Auf GitHub ansehen