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'ü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

  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'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.

Lütfen dikkate alınIronWord'ün belge hiyerarşisi şu yapıyı izler: DocumentDocumentSectionParagraphRunTextContent. 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")
$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ı, 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")
$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'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")
$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?

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")
$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 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")
$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' } };
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")
$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 44,829 | Sürüm: 2026.5 just released
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.