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 ona bir paragraf sonu karakteri eklemeniz gerekir. DocumentBuilder.writeln belgeye bir dizi metin de ekler ancak buna ek olarak bir paragraf sonu da ekler.
Geçerli yazı tipi formatı da font özelliği tarafından belirtilir ve geçerli paragraf formatı paragraph_format özelliği tarafından belirlenir.
Aşağıdaki kod örneği, bir belgeye nasıl paragraf ekleneceğini gösterir:
Paragrafı Biçimlendir
Geçerli paragraf biçimlendirmesi, paragraph_format özelliği tarafından döndürülen bir ParagraphFormat nesnesi tarafından temsil edilir. Bu nesne, Microsoft Word’de mevcut olan çeşitli paragraf biçimlendirme özelliklerini kapsar. clear_formatting‘i çağırarak paragraf formatını varsayılan olarak Normal stile, sola hizalanmış, girintisiz, aralıksız, kenarlıksız ve gölgesiz olarak kolayca sıfırlayabilirsiniz.
Aşağıdaki kod örneği paragraf biçimlendirmesinin nasıl ayarlanacağını gösterir:
Paragraf Stili Uygula
Font veya ParagraphFormat gibi bazı biçimlendirme nesneleri stilleri destekler. Tek bir yerleşik veya kullanıcı tanımlı stil, stilin adı, temel stili, yazı tipi ve paragraf formatı vb. gibi karşılık gelen stil özelliklerini içeren bir Style nesnesi tarafından temsil edilir.
Ayrıca, bir Style nesnesi, bir StyleIdentifier numaralandırma değeriyle temsil edilen yerel ayardan bağımsız bir stil tanımlayıcısını döndüren Style.style_identifier özelliğini sağlar. Önemli olan, Microsoft Word’deki yerleşik stillerin adlarının farklı diller için yerelleştirilmesidir. Bir stil tanımlayıcı kullanarak belgenin dilinden bağımsız olarak doğru stili bulabilirsiniz. Numaralandırma değerleri Normal, Başlık 1, Başlık 2 vb. gibi Microsoft Word yerleşik stillerine karşılık gelir. Kullanıcı tanımlı tüm stillere StyleIdentifier.USER değeri atanı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ı Ekleme
MS Word’de Ctrl + Alt + Enter Klavye Kısayolu kullanılarak paragrafın sonuna stil ayırıcı eklenebilir. Bu özellik, yazdırılan bir mantıksal paragrafta iki farklı paragraf stilinin kullanılmasına olanak tanır. Belirli bir başlığın başlangıcındaki bir metnin İçindekiler Tablosu’nda görünmesini istiyorsanız ancak başlığın tamamının İçindekiler Tablosu’nda görünmesini istemiyorsanız, bu özelliği 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, bir Paragraph sınıfına genel bir break_is_style_separator özelliği sağlar ve aşağıda verilen örnekte gösterildiği gibi Stil Ayırıcı Paragrafın tanımlanmasına olanak tanır:
Paragrafa Kenarlık ve Gölgelendirme Uygulama
Sınırlar BorderCollection tarafından temsil edilir. Bu, indeks veya kenarlık türüne göre erişilen bir Border nesneleri koleksiyonudur. Kenarlık türü BorderType numaralandırmasıyla temsil edilir. Numaralandırmanın bazı değerleri birkaç veya yalnızca bir belge öğesine uygulanabilir. Örneğin, BorderType.BOTTOM bir paragrafa veya tablo hücresine uygulanabilirken, 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 hem BorderCollection hem de Border nesneleri, Border.clear_formatting yöntemini çağırarak bu değerleri varsayılana sıfırlamanıza olanak tanır.
Aspose.Words ayrıca belge öğeleri için gölgelendirme nitelikleri içeren Shading sınıfına da sahiptir. İstediğiniz gölgeleme dokusunu ve öğenin arka planına ve ön planına uygulanan renkleri ayarlayabilirsiniz.
Gölgeleme dokusu, Shading nesnesine çeşitli desenlerin uygulanmasına olanak tanıyan bir TextureIndex numaralandırma değeriyle ayarlanır. Örneğin, bir belge öğesinin arka plan rengini ayarlamak için TextureIndex.TEXTURE_SOLID değerini kullanın ve ön plan gölgeleme rengini uygun şekilde ayarlayın. Aşağıdaki örnekte bir paragrafa kenarlık ve gölgelendirmenin nasıl uygulanacağı gösterilmektedir.
Aşağıdaki kod örneği, bir paragrafa kenarlıkların ve gölgelendirmenin nasıl uygulanacağını gösterir: