Belge Oluşturucuya Genel Bakış
DocumentBuilder, Document ile ilişkilendirilen güçlü bir sınıftır ve sıfırdan dinamik belgeler oluşturmanıza veya mevcut belgelere yeni öğeler eklemenize olanak tanır.
DocumentBuilder, metin, onay kutuları, ole nesneleri, paragraflar, listeler, tablolar, resimler ve diğer içerik öğelerini eklemek için yöntemler sağlar. Yazı tiplerini, paragraf veya bölüm formatını belirlemenize ve diğer işlemleri gerçekleştirmenize olanak tanır.
Belge Oluşturucu veya Aspose.Words DOM
DocumentBuilder, en yaygın belge oluşturma görevlerini basitleştirmek için Aspose.Words Document Object Model’de (DOM) bulunan sınıfları ve yöntemleri tamamlar. Yani, belgelerin içeriğini hem ağaç yapısının iyi anlaşılmasını gerektiren Aspose.Words DOM aracılığıyla hem de DocumentBuilder’ı kullanarak oluşturabilir ve değiştirebilirsiniz. DocumentBuilder, karmaşık Document yapısına yönelik, hızlı ve kolay bir şekilde içerik ve biçimlendirme eklemenizi sağlayan bir “cephedir”.
DocumentBuilder ile mümkün olan işlemler, Aspose.Words DOM’in sınıflarını doğrudan kullanırken de mümkündür. Ancak, Aspose.Words DOM sınıflarını doğrudan kullanmak genellikle DocumentBuilder kullanmaya göre daha fazla kod satırı gerektirir.
Belgede Gezinme
Belgede gezinme, MoveToDocumentStart ve MoveToField gibi çeşitli DocumentBuilder.MoveToXXX yöntemlerini kullanarak belgede başka bir konuma gidebileceğiniz sanal imleç kavramına dayanır. Bu sanal imleç, Write, Writeln, InsertBreak ve diğer yöntemler çağrılırken metnin nereye ekleneceğini gösterir. Sanal imleç hakkında daha fazla bilgi edinmek için aşağıdaki “İmleçle Gezinme” makalesine bakın.
Aşağıdaki kod örneği, bir yer işaretine nasıl gidileceğini gösterir:
Belge Oluşturma ve Değiştirme
Aspose.Words API, bir belgenin çeşitli öğelerinin biçimlendirilmesinden sorumlu olan çeşitli sınıflar sağlar. Sınıfların her biri, metin, paragraf, bölüm ve diğerleri gibi belirli bir belge öğesiyle ilgili biçimlendirme özelliklerini kapsar. Örneğin, Font sınıfı karakter biçimlendirme özelliklerini, ParagraphFormat sınıfı paragraf biçimlendirme özelliklerini vb. temsil eder. Bu sınıfların nesneleri, sınıflarla aynı adlara sahip olan karşılık gelen DocumentBuilder özellikleri tarafından döndürülür. Bu nedenle, belge oluşturma sırasında bunlara erişebilir ve istediğiniz biçimlendirmeyi ayarlayabilirsiniz.
Ayrıca Write yöntemini veya InsertField, InsertHtml ve benzeri yöntemler gibi DocumentBuilder.InsertXXX yöntemlerinden herhangi birini kullanarak imleç konumuna metin, onay kutusu, ole nesnesi, resimler, yer imleri, form alanları ve diğer belge öğeleri ekleyebilirsiniz.
DocumentBuilder kullanarak basit bir belgenin nasıl oluşturulacağını görelim.
DocumentBuilder’ı kullanarak bir Belge oluşturun
Başlamak için bir DocumentBuilder oluşturmanız ve onu bir Document nesnesiyle ilişkilendirmeniz gerekir. Yapıcısını çağırarak yeni bir DocumentBuilder örneği oluşturursunuz ve bunu oluşturucuya eklenmek üzere bir Document nesnesine iletirsiniz.
Metin eklemek için belgeye eklemeniz gereken metin dizesini Write yöntemine iletin.
Aşağıdaki kod örneği, belge oluşturucu kullanarak basit bir belgenin nasıl oluşturulacağını gösterir.
Belge Biçimlendirmesini Belirtin
Font özelliği metin biçimlendirmesini tanımlar. Bu nesne farklı yazı tipi niteliklerini (yazı tipi adı, yazı tipi boyutu, rengi vb.) içerir. Bazı önemli yazı tipi nitelikleri, bunlara doğrudan erişmenize olanak sağlamak için DocumentBuilder özellikleriyle de temsil edilir. Bunlar Font.Bold, Font.Italic ve Font.Underline boole özellikleridir.
Aşağıdaki kod örneği, DocumentBuilder kullanarak biçimlendirilmiş bir metnin nasıl ekleneceğini gösterir:
- Font, belgedeki geçerli konumdan itibaren eklenen tüm metne uygulanacak karakter formatını belirtir.
- ParagraphFormat, geçerli paragrafın ve eklenecek tüm paragrafların paragraf formatını belirtir.
- PageSetup, geçerli bölüm ve eklenecek bölümün tamamı için sayfa ve bölüm özelliklerini belirtir.
- CellFormat ve RowFormat, belgedeki geçerli konumdan itibaren tablo hücrelerine ve satırlara uygulanacak biçimlendirme özelliklerini belirtir.
Bu durumda “geçerli”, imlecin bulunduğu konum, paragraf, bölüm, hücre veya satır anlamına gelir.