How to Add Style to Text in DOCX with C
Klasa TextStyle w IronWord umozliwia deweloperom .NET programowe stosowanie profesjonalnego formatowania tekstu w dokumentach Word, w tym czcionek, kolorow, pogrubienia, kursywy, podkreslen i innych. Niezaleznie od tego, czy generujesz raporty, tworzysz szablony czy automatyzujesz tworzenie dokumentów, IronWord oferuje kompleksowe narzędzia stylizacji odwzorowujace opcje formatowania Microsoft Word.
Szybki start: Stylizacja tekstu w DOCX za pomoca C#
-
Install IronWord with NuGet Package Manager
-
Skopiuj i uruchom ten fragment kodu.
// Quick example using IronWord; using IronWord.Models; // Initialize a new Word document WordDocument doc = new WordDocument(); // Create a Run with styled text Run textRun = new Run(new TextContent("Styled text")); // Apply styling properties to the Run textRun.Style = new TextStyle() { IsBold = true, Color = Color.Red, FontSize = 16, TextFont = new Font() { FontFamily = "Arial" } }; // Create paragraph and add the styled Run Paragraph paragraph = new Paragraph(); paragraph.AddChild(textRun); // Add paragraph to document and save doc.AddParagraph(paragraph); doc.SaveAs("styled.docx"); -
Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronWord w swoim projekcie już dziś z darmową wersją próbną
Minimalny proces (5 kroków)
- Zainstaluj biblioteke IronWord dla C#
- Utworz obiekt
RunzawierajacyTextContent - Zastosuj
TextStyledo obiektuRunz właściwościami takimi jakFontSize,IsBold,Kolor - Dodaj ostylowany obiekt
RundoParagraphza pomocaAddChild - Zapisz dokument z zastosowanymi stylami
Jak dodac styl tekstu do DOCX?
Stosowanie stylow tekstu w IronWord wymaga wykorzystania wzorca opakowania Run. Utworz obiekt WordDocument, nastepnie utworz obiekt Run zawierajacy TextContent z twoim tekstem. Zastosuj TextStyle do Run (nie do TextContent) za pomoca wlasciwosci takich jak IsBold, Color, lub FontSize.
Po sformatowaniu dodaj Run do Paragraph korzystajac z AddChild, wstaw akapit do dokumentu i zapisz wynik. Takie podejście zapewnia programową kontrolę nad formatowaniem tekstu w scenariuszach automatycznego generowania dokumentów wymagających spójnego stylu.
Hierarchia dokumentu IronWord nastepuje wedlug struktury: Document → DocumentSection → Paragraph → Run → TextContent. Style sa stosowane na poziomie Run, nie bezposrednio na TextContent.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-simple.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument("sample.docx");
// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
// Configure text style settings
textRun.Style = new TextStyle()
{
FontSize = 24, // Text Size is 24
TextFont = new Font()
{
FontFamily = "Calibri" // Text Font is "Calibri"
},
Color = Color.Red, // Set text color to red
IsBold = true, // Make text bold
IsItalic = true, // Make text italic
Underline = new Underline(), // Have an underline
Strike = StrikeValue.DoubleStrike, // Double strike-through
};
Paragraph paragraph = new Paragraph();
// Add text to paragraph
paragraph.AddChild(textRun);
// Add paragraph to document
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("add-text-style.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Dim doc As New WordDocument("sample.docx")
' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
' Configure text style settings
textRun.Style = New TextStyle() With {
.FontSize = 24, ' Text Size is 24
.TextFont = New Font() With {
.FontFamily = "Calibri" ' Text Font is "Calibri"
},
.Color = Color.Red, ' Set text color to red
.IsBold = True, ' Make text bold
.IsItalic = True, ' Make text italic
.Underline = New Underline(), ' Have an underline
.Strike = StrikeValue.DoubleStrike ' Double strike-through
}
Dim paragraph As New Paragraph()
' Add text to paragraph
paragraph.AddChild(textRun)
' Add paragraph to document
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("add-text-style.docx")
Jaki będzie wynik tego zadania?
Klasa TextStyle dostarcza podstawowe opcje formatowania, w tym wlasciwosci czcionki, kolor tekstu, pogrubienie, kursywe i podkreslenie. Pamietaj, ze FontSize jest konfigurowany na poziomie TextStyle (nie wewnatrz Font), podczas gdy FontFamily jest ustawiany we wlasciwosci TextFont. Obiekt Run opakowuje TextContent i trzma styl, postepujac wedlug wzorca hierarchii dokumentu IronWord. Przyklad pokazuje, jak rozne wlasciwosci stylow lacza sie, aby stworzyc bogato sformatowany tekst stosowany do Run.
Jakie konkretne style mogę dodać?
Jak zmienić kolor tekstu?
Wlasciwosc Color w TextStyle ustawia kolor tekstu, korzystajac z predefiniowanych kolorow z IronWord.Models.Color lub niestandardowych wartosci heksadecymalnych. Podkreśla to konkretną treść lub pasuje do kolorów marki. IronWord obsługuje szeroką gamę kolorów, w tym czerwony, niebieski, zielony, oliwkowy, granatowy i bordowy.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-text.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add colored text
Run textRun = new Run(new TextContent("This text is olive-colored!"));
textRun.Style = new TextStyle()
{
Color = IronWord.Models.Color.Olive // defining text to be colored olive
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("colored-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add colored text
Dim textRun As New Run(New TextContent("This text is olive-colored!"))
textRun.Style = New TextStyle() With {
.Color = IronWord.Models.Color.Olive ' defining text to be colored olive
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("colored-text.docx")
Jak wygląda tekst w kolorze?
Jak ustawić rodzinę czcionek i rozmiar?
Dostosuj wyglad tekstu za pomoca wlasciwosci TextFont. Ustaw FontFamily na dowolna zainstalowana nazwe czcionki (np. "Arial", "Times New Roman") i FontSize w punktach. Zapewnia to hierarchię wizualną i czytelność na różnych urządzeniach i platformach.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-font.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add text with custom font family and size
Run textRun = new Run(new TextContent("This text uses Arial at 24pt!"));
textRun.Style = new TextStyle()
{
FontSize = 24, // Set font size in points
TextFont = new IronWord.Models.Font()
{
FontFamily = "Arial" // Set font family
}
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("font-styled-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add text with custom font family and size
Dim textRun As New Run(New TextContent("This text uses Arial at 24pt!"))
textRun.Style = New TextStyle() With {
.FontSize = 24, ' Set font size in points
.TextFont = New IronWord.Models.Font() With {
.FontFamily = "Arial" ' Set font family
}
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("font-styled-text.docx")
Jak wygląda niestandardowe stylizowanie czcionek?
Jak pogrubić tekst?
Ustaw wlasciwosc IsBold na true, aby tekst byl Bold. Tekst Bold jest czesto uzywany do naglowkow, podkreslen lub wyroznienia waznych informacji. W polaczeniu z innymi wlasciwosciami stylow, tekst Bold tworzy wizualna hierarchie i poprawia czytelnosc.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-bold.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add bold text
Run textRun = new Run(new TextContent("this is bold!"));
textRun.Style = new TextStyle()
{
IsBold = true // Make text bold
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("bold-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add bold text
Dim textRun As New Run(New TextContent("this is bold!"))
textRun.Style = New TextStyle() With {
.IsBold = True ' Make text bold
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("bold-text.docx")
Jak wygląda pogrubiony tekst?
Jak ustawić tekst kursywą?
Ustaw wlasciwosc IsItalic na true dla stylizacji Italic. Tekst Italic jest zazwyczaj uzywany do wyroznienia, tytulow, slow obcojezycznych lub terminow technicznych. To subtelne formatowanie wyrozna elementy tekstu bez wizualnego ciezaru formatowania Bold.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-italic.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add italic text
Run textRun = new Run(new TextContent("this is italic."));
textRun.Style = new TextStyle()
{
IsItalic = true // Make text italic
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("italic-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add italic text
Dim textRun As New Run(New TextContent("this is italic."))
textRun.Style = New TextStyle() With {
.IsItalic = True ' Make text italic
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("italic-text.docx")
Jak wygląda tekst pisany kursywą?
Jakie są dostępne właściwości stylizacji?
IronWord zapewnia kompleksowe właściwości stylistyczne odzwierciedlające opcje formatowania programu Microsoft WORD. Wszystkie te cechy składają się na złożone formatowanie tekstu spełniające profesjonalne standardy dokumentacji.
| Metoda stylizacji | Opis | Przykład |
|---|---|---|
TextFont |
Dostosowuje wygląd tekstu za pomocą obiektu Font, ustawiając rodzinę czcionek. Uwaga: FontSize jest ustawiane na poziomie TextStyle, a nie wewnątrz Font. |
textRun.Style = new TextStyle() { FontSize = 24, TextFont = new Font() { FontFamily = 'Calibri' } }; |
Kolor |
Ustawia kolor tekstu za pomocą zdefiniowanych kolorów z IronWord.Models.Color lub niestandardowych wartości hex. | textRun.Style.Color = IronWord.Models.Color.Red; |
IsBold |
Nadaje tekstowi styl Bold po ustawieniu na true, powszechnie stosowany do nagłówków lub podkreślenia. |
textRun.Style.IsBold = true; |
IsItalic |
Stylizuje tekst na Italic po ustawieniu na true, zazwyczaj używane do podkreślenia lub tytułów. |
textRun.Style.IsItalic = true; |
Podkreśl |
Dodaje podkreślenie Podkreśl do tekstu używając Podkreśl obiektu z różnymi stylami podkreślenia. |
textRun.Style.Underline = new Underline(); |
Strike |
Nadaje tekstowi przez linię za pomocą StrikeValue enum (Strike lub DoubleStrike). |
textRun.Style.Strike = StrikeValue.Strike; |
Wielkie litery |
Zastosowano wielkie litery w tekście, zamieniając wszystkie znaki na wielkie. | textRun.Style.Caps = true; |
Skala znaków |
Dostosowuje proporcjonalną szerokość znaków jako procent ich normalnego rozmiaru. | textRun.Style.CharacterScale = 150; |
Emboss |
Nakłada efekt wytłoczenia na tekst, tworząc wrażenie wypukłości. | textRun.Style.Emboss = true; |
Nacisk |
Dodaje znaki podkreślenia do tekstu sformatowanego przy użyciu wartości wyliczeniowych EmphasisMarkValues. |
textRun.Style.Emphasis = EmphasisMarkValues.Dot; |
Odstępy między wierszami |
Kontroluje odstępy między wierszami tekstu w celu poprawy czytelności za pomocą obiektu Odstępy między wierszami. |
textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 }; |
Zarys |
Renderuje tekst z efektem konturu, wyświetlając tylko obramowania znaków. | textRun.Style.Outline = true; |
Cieniowanie |
Zastosowanie koloru tła lub cieniowania do tekstu przy użyciu obiektu Cieniowanie. |
textRun.Style.Shading = new Shading() { Color = Color.Yellow }; |
SmallCaps |
Zamienia małe litery na małe wielkie litery, zachowując rozróżnienie wielkości liter. | textRun.Style.SmallCaps = true; |
VerticalPosition |
Dostosowuje pionowe położenie tekstu względem jego linii bazowej, mierzone w punktach. | textRun.Style.VerticalPosition = 5.0; |
Wyrównanie tekstu w pionie |
Wyrównuje tekst w pionie w obrębie kontenera przy użyciu wyliczenia VerticalPositionValues. |
textRun.Style.VerticalTextAlignment = VerticalPositionValues.Superscript; |
Łączenie wielu stylów
Możliwości stylizacji tekstu w IronWord wynikają z łączenia wielu właściwości w celu uzyskania złożonego formatowania. Oto przykład pokazujący profesjonalnie sformatowany tekst dzięki połączeniu różnych właściwości stylizacji:
:path=/static-assets/word/content-code-examples/how-to/add-style-text-7.cs
using IronWord;
using IronWord.Models;
// Create a new document
WordDocument doc = new WordDocument();
// Create richly formatted header text using Run
Run headerRun = new Run(new TextContent("Professional Document Header"));
headerRun.Style = new TextStyle()
{
FontSize = 28,
TextFont = new Font()
{
FontFamily = "Georgia"
},
Color = Color.DarkBlue,
IsBold = true,
SmallCaps = true,
Underline = new Underline(),
CharacterScale = 110, // Slightly expand character width
Shading = new Shading()
{
Color = Color.LightGray // Light background
}
};
// Add header to document using AddChild for styled Run
Paragraph headerParagraph = new Paragraph();
headerParagraph.AddChild(headerRun);
doc.AddParagraph(headerParagraph);
// Create body text with different styling
Run bodyRun = new Run(new TextContent("This is professionally formatted body text with custom styling."));
bodyRun.Style = new TextStyle()
{
FontSize = 11,
TextFont = new Font()
{
FontFamily = "Calibri"
},
Color = Color.Black
};
Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);
// Save the document
doc.SaveAs("professional-document.docx");
Imports IronWord
Imports IronWord.Models
' Create a new document
Dim doc As New WordDocument()
' Create richly formatted header text using Run
Dim headerRun As New Run(New TextContent("Professional Document Header"))
headerRun.Style = New TextStyle() With {
.FontSize = 28,
.TextFont = New Font() With {
.FontFamily = "Georgia"
},
.Color = Color.DarkBlue,
.IsBold = True,
.SmallCaps = True,
.Underline = New Underline(),
.CharacterScale = 110, ' Slightly expand character width
.Shading = New Shading() With {
.Color = Color.LightGray ' Light background
}
}
' Add header to document using AddChild for styled Run
Dim headerParagraph As New Paragraph()
headerParagraph.AddChild(headerRun)
doc.AddParagraph(headerParagraph)
' Create body text with different styling
Dim bodyRun As New Run(New TextContent("This is professionally formatted body text with custom styling."))
bodyRun.Style = New TextStyle() With {
.FontSize = 11,
.TextFont = New Font() With {
.FontFamily = "Calibri"
},
.Color = Color.Black
}
Dim bodyParagraph As New Paragraph()
bodyParagraph.AddChild(bodyRun)
doc.AddParagraph(bodyParagraph)
' Save the document
doc.SaveAs("professional-document.docx")
To kompleksowe podejście do stylizacji pozwala tworzyć dokumenty o spójnym wizerunku marki i profesjonalnym wyglądzie w całym procesie generowania dokumentów przez aplikację.
Często Zadawane Pytania
Jak programowo zastosować formatowanie tekstu w dokumentach Word w C#?
Klasa TextStyle w IronWord umożliwia zastosowanie profesjonalnego formatowania tekstu, w tym czcionek, kolorów, pogrubienia, kursywy i podkreślenia. Wystarczy utworzyć obiekt TextContent z tekstem, zastosować TextStyle z żądanymi właściwościami, dodać go do akapitu i zapisać dokument.
Jakie są podstawowe kroki do stylizacji tekstu w plikach DOCX?
Aby stylizować tekst za pomocą IronWord: 1) Zainstaluj IronWord przez NuGet, 2) Utwórz obiekt WordDocument, 3) Utwórz TextContent z tekstem, 4) Zastosuj właściwości TextStyle, takie jak czcionka, kolor lub pogrubienie, 5) Dodaj tekst do akapitu i zapisz.
Jakie opcje formatowania tekstu są dostępne?
Klasa TextStyle w IronWord zapewnia istotne opcje formatowania, w tym właściwości czcionki (FontFamily i FontSize), kolor tekstu, pogrubienie, kursywę, podkreślenie i przekreślenie. Opcje te można łączyć, aby stworzyć bogato sformatowany tekst.
Jak zmienić rodzinę i rozmiar czcionki tekstu?
Użyj właściwości TextFont w TextStyle, aby określić rodzinę i rozmiar czcionki. Ustaw FontFamily na czcionki takie jak 'Arial' lub 'Times New Roman', a FontSize na żądany rozmiar punktowy, na przykład 16 dla większego tekstu.
Czy mogę jednocześnie zastosować wiele stylów tekstu?
Tak, IronWord pozwala na łączenie wielu właściwości stylizacji w jednym obiekcie TextStyle. Możesz jednocześnie zastosować pogrubienie, kursywę, kolor i zmiany czcionki, aby stworzyć złożone formatowanie tekstu.
Jak zmienić kolor tekstu w dokumentach Word przy użyciu C#?
Właściwość Color w klasie TextStyle w IronWord pozwala na ustawienie koloru tekstu, używając zdefiniowanych kolorów z IronWord.Models.Color lub niestandardowych wartości HEX. Ta funkcja pomaga podkreślić konkretne treści lub dopasować kolory marki w dokumentach.

