How to Add Style to Text in DOCX with C
IronWord'un TextStyle sınıfı, .NET geliştiricilerinin yazı tipleri, renkler, kalın, italik, altı çizili ve daha fazlasını içeren profesyonel metin biçimlendirmelerini programlama yoluyla Word belgelerine uygulamalarını sağlar. 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
-
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,Colorgibi özelliklerleRunüzerineTextStyleuygulayınParagraphiçineAddChildkullanarak stilize edilmişRunekleyin- Uygulanan stillerle belgeyi kaydedin
DOCX'e Metin Stilini Nasıl Eklerim?
IronWord'da metin stilleri uygulamak, Run sarmalayıcı desenini kullanmayı gerektirir. WordDocument nesnesi oluşturun, ardından metninizi içeren TextContent ile bir Run nesnesi oluşturun. Run (TextContent değil) üzerine TextStyle uygulayın, IsBold, Color veya FontSize gibi özellikleri kullanın.
Stil uygulandıktan sonra, AddChild kullanarak Run nesnesini bir Paragraph içine ekleyin, paragrafı belgeye yerleştirin 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, doğrudan TextContent üzerinde değil, Run düzeyinde uygulanır.: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")
Bu Hangi Çıktıyı Üretecek?
TextStyle sınıfı, font özellikleri, metin rengi, kalın, italik ve altı çizili gibi temel biçimlendirme seçenekleri sunar. FontSize'un TextStyle düzeyinde (içinde Font değil) yapılandırıldığını, FontFamily'un ise TextFont özelliği içinde ayarlandığını unutmayın. Run nesnesi, TextContent etrafında sarılır ve stili tutar, IronWord'un belge hiyerarşisi desenini takip eder. Örnek, birden fazla stil özelliğinin bir Run üzerinde uygulandığında zengin biçimlendirilmiş metin oluşturmak için nasıl birleştiğini gösterir.
Hangi Özgün Stilleri Ekleyebilirim?
Metin Rengini Nasıl Değiştiririm?
TextStyle içindeki Color özelliği, IronWord.Models.Color'dan önceden tanımlanmış renkler veya özel hex 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'yı yüklenmiş herhangi bir yazı tipi adına (örneğin, 'Arial', 'Times New Roman') ve FontSize'yi puan 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?
IsBold özelliğini true olarak ayarlayın, metni Bold yapın. Bold metni, genellikle başlıklar, vurgu veya önemli bilgileri vurgulamak için kullanılır. Diğer stil özellikleriyle birleştirildiğinde, Bold metin, görsel 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 özelliğini true olarak ayarlayın, Italic stilini uygulayın. Italic metni, genellikle vurgu, başlıklar, yabancı kelimeler veya teknik terimler için kullanılır. Bu ince biçimlendirme, Bold biçimlendirmesinin görsel ağırlığı olmaksızın metin öğelerini farklılaştı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' } }; |
Color |
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; |
Underline |
Underline 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; |
Caps |
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; |
Emphasis |
EmphasisMarkValues enum değerlerini kullanarak stilize edilmiş metne vurgu işaretleri ekler. |
textRun.Style.Emphasis = EmphasisMarkValues.Dot; |
LineSpacing |
Gelişmiş okunabilirlik için LineSpacing nesnesi kullanarak metin satırları arasındaki boşluğu kontrol eder. |
textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 }; |
Outline |
Metni çevre göze çarpan bir efektle oluşturur, yalnızca karakter sınırlarını gösterir. | textRun.Style.Outline = true; |
Shading |
Bir Shading 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:
: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")
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.

