Paragraflarla Çalışmak
Paragraf, mantıksal bir blok halinde birleştirilen ve özel bir karakterle (paragraf sonu) biten bir karakter kümesidir. Aspose.Words’te bir paragraf Paragraph sınıfı tarafından temsil edilir.
Paragraf Ekle
Belgeye yeni bir paragraf eklemek için aslında bir paragraf sonu karakteri eklemeniz gerekir. DocumentBuilder.Writeln belgeye yalnızca bir metin dizisi eklemekle kalmaz, aynı zamanda bir paragraf sonu da ekler.
Geçerli yazı tipi formatı da Font özelliği tarafından belirtilir ve geçerli paragraf formatı ParagraphFormat özelliği tarafından belirlenir. Bir sonraki bölümde paragraf biçimlendirme hakkında daha ayrıntılı bilgi vereceğiz.
Aşağıdaki kod örneği, bir belgeye nasıl paragraf ekleneceğini gösterir:
Paragrafı Biçimlendir
Geçerli paragraf biçimlendirmesi, ParagraphFormat özelliği tarafından döndürülen ParagraphFormat nesnesi tarafından temsil edilir. Bu nesne, Microsoft Word’de mevcut olan çeşitli paragraf biçimlendirme özelliklerini kapsar. ClearFormatting‘i çağırarak bir paragrafın biçimlendirmesini varsayılan değerine (Normal stil, sola hizalanmış, girintisiz, boşluksuz, kenarlıksız, gölgesiz) kolayca sıfırlayabilirsiniz.
Aşağıdaki kod örneği paragraf biçimlendirmesinin nasıl ayarlanacağını gösterir:
Paragraf Stilini Uygula
Font veya ParagraphFormat gibi bazı biçimlendirme nesneleri stilleri destekler. Yerleşik veya kullanıcı tanımlı bir stil, ad, temel stil, yazı tipi, stil paragraf formatı vb. gibi uygun stil özelliklerini içeren bir Style nesnesi tarafından temsil edilir.
Ayrıca Style nesnesi, StyleIdentifier numaralandırma değeriyle temsil edilen yerel ayardan bağımsız stil tanımlayıcısını döndüren StyleIdentifier özelliğini kullanıma sunar. Gerçek şu ki, Microsoft Word’deki yerleşik stillerin adları farklı diller için yerelleştirilmiştir. Stil tanımlayıcıyı kullanarak belge dilinden bağımsız olarak doğru stili bulabilirsiniz. Numaralandırma değerleri Normal, Başlık 1, Başlık 2 vb. gibi yerleşik Microsoft Word stillerine karşılık gelir. Tüm kullanıcı tanımlı stiller StyleIdentifier.User numaralandırma değerine ayarlanır.
Aşağıdaki kod örneği paragraf stilinin nasıl uygulanacağını gösterir:
Farklı Paragraf Stilleri Koymak için Stil Ayırıcı Ekle
Microsoft Word’te Ctrl+Alt+Enter klavye kısayolu kullanılarak paragrafın sonuna stil ayırıcı eklenebilir. Bu özellik, aynı mantıksal yazdırılmış paragrafta iki farklı paragraf stili kullanmanıza olanak tanır. Belirli bir başlığın başlangıcındaki metnin bir kısmının içindekiler bölümünde görünmesini istiyorsanız ancak başlığın tamamının içindekiler bölümünde görünmesini istemiyorsanız bu işlevi kullanabilirsiniz.
Aşağıdaki kod örneği, farklı paragraf stillerine uyum sağlamak için stil ayırıcının nasıl ekleneceğini gösterir:
Paragraf Stili Ayırıcıyı Tanımlayın
Aspose.Words, aşağıdaki örnekte gösterildiği gibi, bir paragrafı stil ayırıcıyla tanımlamak için Paragraph sınıfındaki BreakIsStyleSeparator ortak özelliğini kullanıma sunar:
Paragrafa Kenarlık ve Gölgelendirme Uygulama
Aspose.Words’teki kenarlıklar BorderCollection sınıfı tarafından temsil edilir; bu, indeks veya kenarlık türüne göre erişilen bir Border nesneleri koleksiyonudur. Kenarlık türü de BorderType numaralandırmasıyla temsil edilir. Bazı numaralandırma değerleri birden fazla veya yalnızca bir belge öğesine uygulanır. Örneğin, BorderType.Bottom bir paragrafa veya tablo hücresine uygulanırken BorderType.DiagonalDown yalnızca tablo hücresindeki çapraz kenarlığı belirtir.
Hem kenarlık koleksiyonu hem de her ayrı kenarlık, renk, çizgi stili, çizgi genişliği, metinden uzaklık ve isteğe bağlı gölge gibi benzer özelliklere sahiptir. Aynı adı taşıyan özelliklerle temsil edilirler. Özellik değerlerini birleştirerek farklı kenarlık türleri elde edebilirsiniz. Ayrıca BorderCollection ve Border nesneleri, ClearFormatting yöntemini çağırarak bu değerleri varsayılan değerlerine sıfırlamanıza olanak tanır.
Aspose.Words ayrıca belge öğeleri için gölgelendirme niteliklerini içeren Shading sınıfına da sahiptir. TextureIndex numaralandırma değerini kullanarak, bir öğenin arka planına ve ön planına uygulanan istenen gölgeleme dokusunu ve renkleri ayarlayabilirsiniz. TextureIndex ayrıca Shading nesnesine farklı desenler uygulamanıza da olanak tanır. Örneğin, bir belge öğesinin arka plan rengini ayarlamak için TextureIndex.TextureSolid değerini kullanın ve ön plan gölgeleme rengini uygun şekilde ayarlayın.
Aşağıdaki kod örneği, bir paragrafa kenarlıkların ve gölgelendirmenin nasıl uygulanacağını gösterir:
Paragraf Satırlarını Say
Herhangi bir Word belgesinin paragrafındaki satır sayısını saymak istiyorsanız aşağıdaki kod örneğini kullanabilirsiniz: