How to Add Style to Text in DOCX with C

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

  1. IronWord aşağıdaki NuGet Paket Yöneticisi ile yükleyin

    PM > Install-Package IronWord
  2. 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");
  3. Canlı ortamınızda test için dağıtım yapın

    Ücretsiz deneme ile bugün projenizde IronWord kullanmaya başlayın

    arrow pointer

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.

Lütfen dikkate alınIronWord'un belge hiyerarşisi şu yapıyı takip eder: DocumentDocumentSectionParagraphRunTextContent. 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")
$vbLabelText   $csharpLabel

Bu Hangi Çıktıyı Üretecek?

Microsoft Word arabirimi, Düzen sekmesi ve üzerine kırmızı üstü çizili metin biçimlendirmesi uygulanmış belgeyi gösterir

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")
$vbLabelText   $csharpLabel

Renkli Metin Nasıl Görünür?

Microsoft Word'de Font ve Paragraf araçlarını gösteren Home sekmesi bulunan zeytin renkli metin formatı

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")
$vbLabelText   $csharpLabel

Özelleştirilmiş Yazı Biçimlendirmesi Nasıl Görünür?

Microsoft Word'de 24pt Arial yazı tipini gösteren araç çubuğunda seçili ve biçimlendirilmiş örnek metin gösterir

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")
$vbLabelText   $csharpLabel

Kalın Metin Nasıl Görünür?

Bu, Microsoft Word arabirimi kalın metin biçimlendirmesi 'bu kalındır!' metniyle belgeyi gösterir

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")
$vbLabelText   $csharpLabel

İtalik Metin Nasıl Görünür?

Word belgesi, Home sekmesi biçimlendirme seçenekleri görünür olan arabirimde italik metni gösterir

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")
$vbLabelText   $csharpLabel

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.

Ahmad Sohail
Full Stack Geliştirici

Ahmad, C#, Python ve web teknolojilerinde sağlam bir temele sahip bir full-stack geliştiricidir. Gerçek dünyadaki uygulamalarda ölçeklenebilir yazılım çözümleri oluşturmaktan ve tasarım ile işlevselliğin nasıl buluştuğunu keşfetmekten derin bir ilgi duyar.

...

Daha Fazla Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 49,323 | Sürüm: 2026.7 yeni yayınlandı
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz? PM > Install-Package IronWord
bir örnek çalıştırın verilerinizi bir Word belgesine dönüştürün.