TextPath

TextPath class

Metin yolunun (bir WordArt nesnesinin) metnini ve biçimlendirmesini tanımlar.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Şekillerle Çalışmak dokümantasyon makalesi.

public class TextPath

Özellikleri

İsimTanım
Bold { get; set; }Yazı tipi kalın olarak biçimlendirilmişse doğrudur.
FitPath { get; set; }Metnin bir şeklin yoluna uyup uymayacağını tanımlar.
FitShape { get; set; }Metnin bir şeklin sınırlayıcı kutusuna uyup uymayacağını tanımlar.
FontFamily { get; set; }Metin yolu yazı tipinin ailesini tanımlar.
Italic { get; set; }Yazı tipi italik olarak biçimlendirilmişse doğrudur.
Kerning { get; set; }Karakter aralığının açık olup olmadığını belirler.
On { get; set; }Metnin görüntülenip görüntülenmeyeceğini tanımlar.
ReverseRows { get; set; }Satırların düzen sırasının tersine çevrilip çevrilmeyeceğini belirler.
RotateLetters { get; set; }Metnin harflerinin döndürülüp döndürülmeyeceğini belirler.
SameLetterHeights { get; set; }İlk harfe bakılmaksızın tüm harflerin aynı yükseklikte olup olmayacağını belirler.
Shadow { get; set; }Metin yolundaki metne gölge uygulanıp uygulanmayacağını tanımlar.
Size { get; set; }Yazı tipinin boyutunu nokta cinsinden tanımlar.
SmallCaps { get; set; }Yazı tipi küçük büyük harflerle biçimlendirilmişse doğrudur.
Spacing { get; set; }Metin için boşluk miktarını tanımlar. 1, %100 anlamına gelir.
StrikeThrough { get; set; }Yazı tipi üstü çizili metin olarak biçimlendirilmişse doğrudur.
Text { get; set; }Metin yolunun metnini tanımlar.
TextPathAlignment { get; set; }Metnin hizalamasını tanımlar.
Trim { get; set; }Metnin üstünde ve altında fazladan boşluğun kaldırılıp kaldırılmayacağını belirler.
Underline { get; set; }Yazı tipinin altı çiziliyse doğrudur.
XScale { get; set; }Şekil yolu yerine düz metin yolunun kullanılıp kullanılmayacağını belirler.

Notlar

KullanTextPath bir şeklin WordArt özelliklerine erişim özelliği. Şeklin örneklerini oluşturmazsınızTextPath doğrudan sınıf.

Örnekler

WordArt’la nasıl çalışılacağını gösterir.

public void InsertTextPaths()
{
    Document doc = new Document();

    // Metni Microsoft Word'de fareyi kullanarak yeniden boyutlandırabileceğimiz ve taşıyabileceğimiz bir şekilde görüntülemek için bir WordArt nesnesi ekleyin.
    // WordArt'a şekil ayarlamak için bağımsız değişken olarak bir "ShapeType" sağlayın.
    Shape shape = AppendWordArt(doc, "Hello World! This text is bold, and italic.", 
        "Arial", 480, 24, Color.White, Color.Black, ShapeType.TextPlainText);

    // İlgili özellikleri kullanarak "Kalın" ve "İtalik" biçimlendirme ayarlarını metne uygulayın.
    shape.TextPath.Bold = true;
    shape.TextPath.Italic = true;

    // Aşağıda metin biçimlendirmeyle ilgili diğer çeşitli özellikler bulunmaktadır.
    Assert.False(shape.TextPath.Underline);
    Assert.False(shape.TextPath.Shadow);
    Assert.False(shape.TextPath.StrikeThrough);
    Assert.False(shape.TextPath.ReverseRows);
    Assert.False(shape.TextPath.XScale);
    Assert.False(shape.TextPath.Trim);
    Assert.False(shape.TextPath.SmallCaps);

    Assert.AreEqual(36.0, shape.TextPath.Size);
    Assert.AreEqual("Hello World! This text is bold, and italic.", shape.TextPath.Text);
    Assert.AreEqual(ShapeType.TextPlainText, shape.ShapeType);

    // Metni göstermek/gizlemek için "Açık" özelliğini kullanın.
    shape = AppendWordArt(doc, "On set to \"true\"", "Calibri", 150, 24, Color.Yellow, Color.Red, ShapeType.TextPlainText);
    shape.TextPath.On = true;

    shape = AppendWordArt(doc, "On set to \"false\"", "Calibri", 150, 24, Color.Yellow, Color.Purple, ShapeType.TextPlainText);
    shape.TextPath.On = false;

    // Belirli karakterler arasındaki karakter aralığı aralığını etkinleştirmek/devre dışı bırakmak için "Karakter Aralığı" özelliğini kullanın.
    shape = AppendWordArt(doc, "Kerning: VAV", "Times New Roman", 90, 24, Color.Orange, Color.Red, ShapeType.TextPlainText);
    shape.TextPath.Kerning = true;

    shape = AppendWordArt(doc, "No kerning: VAV", "Times New Roman", 100, 24, Color.Orange, Color.Red, ShapeType.TextPlainText);
    shape.TextPath.Kerning = false;

    // Karakterler arasındaki özel aralığı 0,0 (yok) ila 1,0 (varsayılan) arasında ayarlamak için "Boşluk" özelliğini kullanın.
    shape = AppendWordArt(doc, "Spacing set to 0.1", "Calibri", 120, 24, Color.BlueViolet, Color.Blue, ShapeType.TextCascadeDown);
    shape.TextPath.Spacing = 0.1;

    // Her karakteri saat yönünün tersine 90 derece döndürmek için "RotateLetters" özelliğini "true" olarak ayarlayın.
    shape = AppendWordArt(doc, "RotateLetters", "Calibri", 200, 36, Color.GreenYellow, Color.Green, ShapeType.TextWave);
    shape.TextPath.RotateLetters = true;

    // Her karakterin x yüksekliğini büyük harf yüksekliğine eşitlemek için "SameLetterHeights" özelliğini "true" olarak ayarlayın.
    shape = AppendWordArt(doc, "Same character height for lower and UPPER case", "Calibri", 300, 24, Color.DeepSkyBlue, Color.DodgerBlue, ShapeType.TextSlantUp);
    shape.TextPath.SameLetterHeights = true;

    // Varsayılan olarak metnin boyutu, metin boyutu ayarını geçersiz kılarak her zaman içerdiği şeklin boyutuna uyacak şekilde ölçeklenir.
    shape = AppendWordArt(doc, "FitShape on", "Calibri", 160, 24, Color.LightBlue, Color.Blue, ShapeType.TextPlainText);
    Assert.True(shape.TextPath.FitShape);
    shape.TextPath.Size = 24.0;

    // "FitShape: özelliğini "false" olarak ayarlarsak metin boyutu korunacaktır
    // şeklin boyutundan bağımsız olarak "Size" özelliğinin belirttiği değer.
    // Metni şeklin bir kenarına hizalamak için "TextPathAlignment" özelliğini de kullanın.
    shape = AppendWordArt(doc, "FitShape off", "Calibri", 160, 24, Color.LightBlue, Color.Blue, ShapeType.TextPlainText);
    shape.TextPath.FitShape = false;
    shape.TextPath.Size = 24.0;
    shape.TextPath.TextPathAlignment = TextPathAlignment.Right;

    doc.Save(ArtifactsDir + "Shape.InsertTextPaths.docx");
}

/// <summary>
/// İçinde WordArt şekli bulunan yeni bir paragraf ekleyin.
/// </summary>
private static Shape AppendWordArt(Document doc, string text, string textFontFamily, double shapeWidth, double shapeHeight, Color wordArtFill, Color line, ShapeType wordArtShapeType)
{
    // WordArt'ımız için kapsayıcı görevi görecek bir satır içi Şekil oluşturun.
    // Şekil yalnızca ona WordArt tarafından atanmış bir ShapeType atarsak geçerli bir WordArt şekli olabilir.
    // Bu türlerin açıklamasında "WordArt nesnesi" bulunur,
    // ve bunların numaralayıcı sabit adlarının tümü "Metin" ile başlayacaktır.
    Shape shape = new Shape(doc, wordArtShapeType)
    {
        WrapType = WrapType.Inline,
        Width = shapeWidth,
        Height = shapeHeight,
        FillColor = wordArtFill,
        StrokeColor = line
    };

    shape.TextPath.Text = text;
    shape.TextPath.FontFamily = textFontFamily;

    Paragraph para = (Paragraph)doc.FirstSection.Body.AppendChild(new Paragraph(doc));
    para.AppendChild(shape);
    return shape;
}

Ayrıca bakınız