Jak dodać efekt konturu tekstu w języku C

Dlaczego warto używać TextOutlineEffect do stylizacji tekstu?

Aby zastosować efekt konturu tekstu, stwórz TextStyle i uzupełnij jego właściwość TextEffect za pomocą TextOutlineEffect. Następnie stwórz Paragraph, a potem Run zawierający TextContent. Przypisz TextStyle do Run (nie do TextContent), a następnie użyj AddChild, aby dodać Run do Paragraph. To odzwierciedla hierarchię dokumentu: Dokument → Akapit → Fragment tekstu → Zawartość tekstu.

Klasa TextOutlineEffect zapewnia kompleksowe API do kontroli kazdego aspektu konturowania tekstu. W przeciwieństwie do podstawowych opcji formatowania tekstu, oferuje precyzyjną kontrolę nad właściwościami konturu, takimi jak szerokość linii, kolor, wyrównanie pióra i wzory kresek. Ten poziom kontroli jest niezbędny podczas tworzenia profesjonalnych dokumentów, które muszą spełniać określone wytyczne dotyczące marki lub wymagania dotyczące dostępności.

W przypadku aplikacji biznesowych konspekt tekstu może znacznie poprawić czytelność dokumentu podczas drukowania na różnych rodzajach papieru lub gdy dokumenty będą wyświetlane na różnych urządzeniach. Kontur tworzy strefę buforową wokół każdej litery, zapewniając czytelność tekstu nawet na zagraconym tle lub w warunkach niskiego kontrastu.

Jaki jest podstawowy wzorzec kodu do dodawania konspektów?

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

// 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")

Ten podstawowy wzorzec ilustruje fundamentalne podejście do stosowania konspektów tekstowych. Kod tworzy nowy dokument, definiuje styl tekstu z domyślnym efektem konturu, stosuje go do tekstu i zapisuje wynik. DefaultEffect zapewnia wyważony kontur, który dobrze działa w większości sytuacji, zawierający subtelną szerokość i komplementarny kolor, który wzmacnia tekst zamiast go przytłaczać.

Jakie właściwości kontrolują wygląd konspektu?

Efekt konturu tekstu oferuje szereg właściwości, które można dostosować do dowolnych potrzeb projektowych. Zrozumienie tych właściwości pozwala tworzyć szkice, które idealnie pasują do wymagań wizualnych dokumentu i wytycznych dotyczących marki. Poniżej znajdują się właściwości wraz z ich opisami:

Każda właściwość służy konkretnemu celowi w tworzeniu profesjonalnie wyglądających konspektów tekstów. Na przykład LineWidth bezpośrednio wpływa na wizualną wyrazistość - cieńsze kontury (0.1-0.3 punktu) tworzą subtelny akcent, podczas gdy grubsze kontury (1.0-2.0 punktu) stanowią odważne deklaracje. Właściwość Color jest kluczowa dla utrzymania spójności marki oraz zapewnienia odpowiedniego kontrastu dla dostępności.

Jak zastosować niestandardowe właściwości konspektu?

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

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

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

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

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

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

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' 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 = 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
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

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

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

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

Ten zaawansowany przykład pokazuje pełną moc konfiguracji niestandardowego konspektu. Kod tworzy charakterystyczną czerwoną obwódkę w stylu podwójnej linii, pokazując, w jaki sposób wiele właściwości współdziała, aby osiągnąć określone efekty wizualne. Zaokrąglone końcówki linii i ścięte połączenia tworzą płynne, profesjonalnie wyglądające kontury, które dobrze sprawdzają się w nagłówkach i tytułach.

Podczas wdrażania niestandardowych konspektów w aplikacjach produkcyjnych warto rozważyć utworzenie szablonów stylów, które można ponownie wykorzystać. Zdefiniuj standardowe konfiguracje struktur dla różnych elementów dokumentu (nagłówki, podnagłówki, tekst wyróżniony) i zapisz je jako stałe lub ustawienia konfiguracyjne. Takie podejście zapewnia spójność w całym procesie tworzenia dokumentów i ułatwia aktualizację w przypadku zmian w wytycznych dotyczących marki.

Aby uzyskać optymalne wyniki, przetestuj efekty swojego szkicu w różnych formatach wyjściowych i warunkach wyświetlania. To, co wygląda dobrze na ekranie, może wymagać dostosowania do wydruku PRINT. Przy wyborze szerokości i kolorów konturów należy wziąć pod uwagę takie czynniki, jak rozdzielczość drukarki, kolor papieru i odległość oglądania. Elastyczność klasy TextOutlineEffect IronWord pozwala programowo dostrajać te parametry na podstawie wymagań dotyczących wyjścia.