C# Dilinde Metin Çizgi Çizgisi Efekti Ekleme

Metin Stili İçin TextOutlineEffect Kullanmalı mıyım?

Metin kontur efekti uygulamak için bir TextStyle oluşturun ve TextEffect özelliğini bir TextOutlineEffect ile doldurun. Ardından bir Paragraph oluşturun, ardından Run içeren bir TextContent ekleyin. TextStyle'yi Run'ye (TextContent'ye değil) atayın, ardından AddChild kullanarak Run'yi Paragraph'ye ekleyin. Bu, belge sıralamasını takip eder: Document → Paragraph → Run → TextContent.

TextOutlineEffect sınıfı, metin taslaklarınızın her yönünü kontrol etmek için kapsamlı bir API sağlar. Temel metin biçimlendirme seçeneklerinden farklı olarak, çizgi genişliği, renk, kalem hizalaması ve çizgi desenleri gibi çizgi özellikleri üzerinde hassas kontrol sunar. Bu kontrol düzeyi, belirli marka yönergelerine veya erişilebilirlik gereksinimlerine uyması gereken profesyonel belgeler oluştururken gereklidir.

İş uygulamaları için, metin çizgi çizgileri, farklı kağıt türlerine yazdırılırken veya belgeler farklı cihazlarda görüntüleneceğinde belge okunabilirliğini önemli ölçüde artırabilir. Çizgi, her karakterin etrafında bir tampon bölgesi oluşturarak, yoğun arka planlar veya düşük kontrast senaryolarına karşı bile metnin okunabilirliğini sağlar.

Çizgi Eklemeler İçin Temel Kod Deseni Nedir?

:path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-effect.cs

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

Imports IronWord
Imports IronWord.Models

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = TextOutlineEffect.DefaultEffect
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Hello World"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("textOutlineEffect.docx")

Bu temel desen, metin çizgi çizgileri uygulamanın temel yaklaşımını göstermektedir. Kod yeni bir belge oluşturur, varsayılan çizgi efektiyle bir metin stili tanımlar, metne uygular ve sonucu kaydeder. DefaultEffect, çoğu senaryo için uygun olan dengeli bir taslak sunar; metni boğmak yerine onu zenginleştiren ince bir genişlik ve tamamlayıcı renkler içerir.

Çizgi Görünümünü Hangi Özellikler Kontrol Eder?

Metin çizgi çizgisi efekti, herhangi bir tasarım ihtiyacına uyacak bir dizi özelleştirilebilir özellik sunar. Bu özellikleri anlamak, belgelerinizin görsel gereksinimlerine ve marka yönergelerine mükemmel bir şekilde uyan çizgiler oluşturmanızı sağlar. Aşağıda özellikleri ve açıklamaları yer almaktadır:

Her özellik, profesyonel görünümlü metin çizgi çizgileri oluşturmak için belirli bir amaca hizmet eder. Örneğin, LineWidth görsel göze çarpma üzerinde doğrudan etki eder – daha ince konturlar (0,1-0,3 punto) ince bir vurgu yaratırken, daha kalın konturlar (1,0-2,0 punto) daha belirgin bir vurgu oluşturur. Color özelliği, marka tutarlılığını korumak ve erişilebilirlik için yeterli kontrastı sağlamak açısından çok önemlidir.

Özel Çizgi Özellikleri Nasıl Uygulanır?

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized text outline"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Create new Word document
Dim doc As New WordDocument()

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .TextOutlineEffect = New TextOutlineEffect() With {
        .Color = IronWord.Models.Color.Red,
        .CompoundLineType = CompoundLineValues.Double,
        .LineCapType = LineCapValues.Round,
        .LineJoin = StrokeJoinStyleValues.Bevel,
        .LineWidth = 0.3,
        .PenAlignment = PenAlignmentValues.Center,
        .presetLineDash = PresetLineDashValues.Solid
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized text outline"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx")

Bu gelişmiş örnek, özel çizgi yapılandırmasının tam gücünü sergiler. Kod, çift çizgi stiliyle belirgin bir kırmızı çizgi oluşturur, birden çok özelliğin belirli görsel efektler elde etmek için birlikte nasıl çalıştığını gösterir. Yuvarlak çizgi kaplamaları ve eğik birleştirmeler, başlıklar ve başlıklar için iyi çalışan pürüzsüz, profesyonel görünümlü çizgiler oluşturur.

Özel çizgi karakter özellikleri uygulandığında, yeniden kullanılabilir stil şablonları oluşturmayı düşünün. Farklı belge öğeleri (başlıklar, alt başlıklar, vurgu metni) için standart çizgi yapılandırmaları tanımlayın ve bunları sabitler veya yapılandırma ayarları olarak saklayın. Bu yaklaşım, belge oluşturma hattınızda tutarlılığı sağlar ve marka yönergeleri değiştiğinde bakımı kolaylaştırır.

Optimum sonuçlar için, farklı çıktı formatları ve görüntüleme koşulları boyunca çizgi efektlerinizi test edin. Ekranda harika görünen şey, baskı çıktısı için ayarlama gerektirebilir. Yazıcı çözünürlüğü, kağıt rengi ve görüntüleme mesafesi gibi faktörleri çizgi genişliklerini ve renklerini seçerken dikkate alın. IronWord'ün TextOutlineEffect sınıfının esnekliği, çıktı gereksinimlerine göre bu parametreleri programlı olarak ince ayarlamanıza olanak tanır.