How to Add Style to Text in DOCX with C
IronWord'ün TextStyle sınıfı, .NET geliştiricilerinin WORD belgelerine programlı olarak yazı tipi, renk, kalın, italik, altı çizili ve daha fazlasını içeren Professional metin biçimlendirme uygulamalarını uygulamasına olanak tanır. Raporlar oluşturuyor, şablonlar yapıyor veya belge oluşturma işlemini otomatikleştiriyorsanız, IronWord Microsoft Word'ün biçimlendirme seçeneklerine benzer kapsamlı stil araçları sunar.
Hızlı Başlangıç: C# ile DOCX'te Metni Stilize Etme
-
IronWord aşağıdaki NuGet Paket Yöneticisi ile yükleyin
PM > Install-Package IronWord -
Bu kod parçacığını kopyalayın ve çalıştırın.
// 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"); -
Canlı ortamınızda test için dağıtım yapın
Ücretsiz deneme ile bugün projenizde IronWord kullanmaya başlayın
Asgari İş Akışı (5 adım)
- IronWord C# kütüphanesini kurun
TextContentiçeren birRunnesnesi oluşturunFontSize,IsBold,Renkgibi özelliklerleRunüzerineTextStyleuygulayınParagraphiçineAddChildkullanarak stilize edilmişRunekleyin- Uygulanan stillerle belgeyi kaydedin
DOCX'e Metin Stilini Nasıl Eklerim?
IronWord'de metin stilleri uygulamak için Run sarmalayıcı kalıbının kullanılması gerekir. Bir WordDocument nesnesi oluşturun, ardından metninizi içeren TextContent öğesini barındıran bir Run nesnesi oluşturun. TextStyle'yi Run'ye (TextContent'ye değil) IsBold, Color veya FontSize gibi özellikleri kullanarak TextStyle'yi Run'ye (TextContent'ye değil) uygulayın.
Biçimlendirildikten sonra, Run öğesini Paragraph öğesine AddChild kullanarak ekleyin, paragrafı belgeye ekleyin ve sonucu kaydedin. Bu yaklaşım, tutarlı stil talepleri olan otomatik belge oluşturma senaryoları için metin biçimlendirmesi üzerinde programatik kontrol sağlar.
Document → DocumentSection → Paragraph → Run → TextContent. Stiller Run düzeyinde uygulanır, doğrudan TextContent üzerinde değil.: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, // No 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 ' No 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")
Bu Hangi Çıktıyı Üretecek?
TextStyle sınıfı, yazı tipi özellikleri, metin rengi, kalın, italik ve altı çizili gibi temel biçimlendirme seçenekleri sunar. FontSize'nin TextStyle düzeyinde (Font içinde değil) yapılandırıldığını, FontFamily'nin ise TextFont özelliği içinde ayarlandığını unutmayın. Run nesnesi, TextContent nesnesini sarar ve IronWord'ün belge hiyerarşisi modelini takip ederek stili korur. Örnek, Run'ye uygulandığında birden fazla stil özelliğinin bir araya gelerek zengin biçimlendirilmiş metin oluşturduğunu göstermektedir.
Hangi Özgün Stilleri Ekleyebilirim?
Metin Rengini Nasıl Değiştiririm?
Color içindeki TextStyle özelliği, IronWord.Models.Color içindeki önceden tanımlanmış renkleri veya özel onaltılık değerleri kullanarak metin rengini ayarlar. Bu, belirli içeriği vurgular veya marka renkleriyle eşleşir. IronWord, Kırmızı, Mavi, Yeşil, Zeytin, Lacivert, ve Bordo dahil geniş bir renk yelpazesini destekler.
: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")
Renkli Metin Nasıl Görünür?
Yazı Tipi Ailesi ve Boyutunu Nasıl Ayarlayabilirim?
TextFont özelliği ile metin görünümünü özelleştirin. FontFamily'yi yüklü herhangi bir yazı tipi adına (ör. "Arial", "Times New Roman") ve FontSize'yi punto cinsinden ayarlayın. Bu, görsel hiyerarşi kurar ve farklı cihazlar ve platformlarda okunabilirliği sağlar.
: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")
Özelleştirilmiş Yazı Biçimlendirmesi Nasıl Görünür?
Metni Nasıl Kalınlaştırırım?
Metni Bold yapmak için IsBold özelliğini true olarak ayarlayın. Bold metni genellikle başlıklar, vurgu veya önemli bilgileri öne çıkarmak için kullanılır. Diğer stil özellikleriyle birleştirildiğinde, Bold metni görsel bir hiyerarşi oluşturur ve okunabilirliği artırır.
: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")
Kalın Metin Nasıl Görünür?
Metni Nasıl İtalikleştiririm?
IsItalic stilini uygulamak için true özelliğini Italic olarak ayarlayın. Italic metni genellikle vurgu, başlık, yabancı kelimeler veya teknik terimler için kullanılır. Bu ince biçimlendirme, Bold biçimlendirmesinin görsel ağırlığı olmadan metin öğelerini birbirinden ayırır.
: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")
İtalik Metin Nasıl Görünür?
Kullanılabilir Stil Özellikleri Nelerdir?
IronWord, Microsoft Word'ün biçimlendirme seçeneklerini yansıtan kapsamlı stil özellikleri sunar. Bu özellikler profesyonel belge standartlarını karşılayan karmaşık metin formatlarını oluşturmak için birleşir.
| Stil Yöntemi | Açıklama | Örnek |
|---|---|---|
TextFont |
Font nesnesi ile metin görünümünü özelleştirir, yazı tipi ailesini ayarlar. Not: FontSize TextStyle seviyesinde ayarlanır, Font içinde değil. |
textRun.Style = new TextStyle() { FontSize = 24, TextFont = new Font() { FontFamily = 'Calibri' } }; |
Renk |
Metin rengini, IronWord.Models.Color içerisindeki tanımlı renkleri kullanarak veya özel hex değerleriyle ayarlar. | textRun.Style.Color = IronWord.Models.Color.Red; |
IsBold |
true olarak ayarlandığında metni Kalın yapar, genellikle başlıklar veya vurgu için kullanılır. |
textRun.Style.IsBold = true; |
IsItalic |
true olarak ayarlandığında metne İtalik stilini uygular, genellikle vurgu veya başlıklar için kullanılır. |
textRun.Style.IsItalic = true; |
Altı çizili |
Altı çizili nesnesi kullanılarak çeşitli alt çizgi stilleri ile metne Altlını Çizme ekler. |
textRun.Style.Underline = new Underline(); |
Strike |
Metne StrikeValue numaralandırmaı (Strike veya DoubleStrike) kullanarak üstünü çizme uygular. |
textRun.Style.Strike = StrikeValue.Strike; |
Büyük harfler |
Metne büyük harf efekti uygular, tüm karakterleri büyük harfe dönüştürür. | textRun.Style.Caps = true; |
CharacterScale |
Karakterlerin normal boyutlarının orantılı genişliğini yüzde olarak ayarlar. | textRun.Style.CharacterScale = 150; |
Emboss |
Metne kabartma efekti uygular, yükseltilmiş bir görünüm oluşturur. | textRun.Style.Emboss = true; |
Vurgu |
EmphasisMarkValues enum değerlerini kullanarak stilize edilmiş metne vurgu işaretleri ekler. |
textRun.Style.Emphasis = EmphasisMarkValues.Dot; |
Satır Aralığı |
Gelişmiş okunabilirlik için Satır Aralığı nesnesi kullanarak metin satırları arasındaki boşluğu kontrol eder. |
textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 }; |
Ana hatlar |
Metni çevre göze çarpan bir efektle oluşturur, yalnızca karakter sınırlarını gösterir. | textRun.Style.Outline = true; |
Gölgelendirme |
Bir Gölgelendirme nesnesi kullanarak metne arka plan rengi veya gölgelendirme uygular. |
textRun.Style.Shading = new Shading() { Color = Color.Yellow }; |
SmallCaps |
Büyük/küçük harf ayrımını koruyarak küçük harfleri küçük büyük harflere dönüştürür. | textRun.Style.SmallCaps = true; |
VerticalPosition |
Metnin, temel çizgisine göre dikey yerleşimini, puanlar ile ayarlar. | textRun.Style.VerticalPosition = 5.0; |
VerticalTextAlignment |
VerticalPositionValues enum kullanarak metni dikey olarak kaplayana yerleştirir. |
textRun.Style.VerticalTextAlignment = VerticalPositionValues.Superscript; |
Çoklu Stilleri Birleştirme
IronWord'un metin stil gücü, karmaşık biçimlendirmeyi başarmak sağlar, için birçok özelliği birleştirmekten gelir. İşte farklı stil özellikleriyle profesyonelce stil verilmiş metni gösteren bir örnek:
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,
LineSpacing = new LineSpacing() { Value = 1.15 } // Slightly increased line spacing
};
Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);
// Save the document
doc.SaveAs("professional-document.docx");
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,
LineSpacing = new LineSpacing() { Value = 1.15 } // Slightly increased line spacing
};
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,
.LineSpacing = New LineSpacing() With {.Value = 1.15} ' Slightly increased line spacing
}
Dim bodyParagraph As New Paragraph()
bodyParagraph.AddChild(bodyRun)
doc.AddParagraph(bodyParagraph)
' Save the document
doc.SaveAs("professional-document.docx")
Bu kapsamlı stil yaklaşımı, uygulamanızın belge oluşturma süreci boyunca tutarlı bir marka ve profesyonel bir görünüm sağlayan belgeler oluşturur.
Sıkça Sorulan Sorular
Word belgelerine programatik olarak metin biçimlendirmeyi nasıl uygularım C#?
IronWord'un TextStyle sınıfı, profesyonel metin biçimlendirmelerini uygulamanıza olanak tanır; yazı tipleri, renkler, kalın, italik ve altı çizili dahil. Metninizle bir TextContent nesnesi oluşturun, istenen özelliklerle bir TextStyle uygulayın, bir paragrafa ekleyin ve belgeyi kaydedin.
DOCX dosyalarında metin stilize etmenin temel adımları nelerdir?
IronWord ile metin stilize edin: 1) NuGet ile IronWord kurun, 2) Bir WordDocument nesnesi oluşturun, 3) Metninizle TextContent oluşturun, 4) Yazı tipi, renk veya kalın gibi TextStyle özellikleri uygulayın, 5) Metni bir paragrafa ekleyin ve kaydedin.
Hangi metin biçimlendirme seçenekleri mevcuttur?
IronWord'un TextStyle sınıfı, yazı tipi özellikleri (FontFamily ve FontSize), metin rengi, kalın, italik, altı çizili ve üstü çizili dahil olmak üzere gerekli biçimlendirme seçeneklerini sağlar. Bu seçenekler, zengin formatlı metinler oluşturmak için bir araya getirilebilir.
Metnin yazı tipi ailesi ve boyutunu nasıl değiştiririm?
TextStyle içindeki TextFont özelliğini kullanarak yazı tipi ailesini ve boyutunu belirtin. 'Arial' veya 'Times New Roman' gibi yazı tiplerini FontFamily'e, daha büyük metinler için 16 gibi istediğiniz punto boyutunu FontSize'a ayarlayın.
Aynı anda birden fazla metin stili uygulayabilir miyim?
Evet, IronWord size tek bir TextStyle nesnesinde birden fazla stil özelliğini birleştirmenize izin verir. Karmaşık metin biçimlendirmeleri oluşturmak için kalın, italik, renk ve yazı tipi değişikliklerini aynı anda uygulayabilirsiniz.
C# kullanarak Word belgelerinde metin rengini nasıl değiştiririm?
IronWord'un TextStyle içindeki Color özelliği, metin rengini IronWord.Models.Color'den önceden tanımlanmış renkler veya özel hex değerleri kullanarak ayarlamanızı sağlar. Bu özellik, belgelerinizde belirli içeriği vurgulamanıza veya marka renklerine uymanıza yardımcı olur.

