Document Builder Genel Bakış
DocumentBuilder güçlü bir sınıftır ve Document‘le ilişkilidir ve sizden sıfırdan dinamik belgeler oluşturmanıza veya var olanlara yeni öğeler eklemenize olanak tanır.
DocumentBuilder metin, onay kutuları, ole nesneleri, paragraflar, listeler, tablolar, resimler ve diğer içerik öğeleri eklemek için yöntemler sağlar. Yazı tiplerini, paragraf veya bölüm biçimlendirmesini belirtmenize izin verir ve diğer işlemleri gerçekleştirir.
Document Oluşturucu veya Aspose.Words DOM
DocumentBuilder mevcut sınıfları ve yöntemleri Aspose.Words Document Object Model (DOM) ile birleştirerek en yaygın belge oluşturma görevlerini basitleştirir. Yani, bir belgenin içeriğini ve yapısını hem Aspose.Words DOM aracılığıyla (bir ağaç yapısına ilişkin iyi bir anlayış gerektirdiği) hem de DocumentBuilder kullanarak oluşturabilir ve değiştirebilirsiniz. DocumentBuilder, karmaşık Document yapısının “kapısı"dır, böylece içeriği hızlı ve kolay bir şekilde ekleyebilir ve biçimlendirebilirsiniz.
DocumentBuilder ile mümkün olan işlemler ayrıca Aspose.Words DOM sınıflarını doğrudan kullandığında da mümkündür. Fakat genellikle Aspose.Words DOM sınıflarını direkt olarak kullanmak, DocumentBuilder‘u kullanarak kod yazmaktan daha fazla satır gerektirecektir.
Doküman Gezintisi
Belge gezintisi, çeşitli yöntemler kullanılarak belgedeki bir başka konuma geçebileceğinizi belirten kavramı bir sanal imleç etrafında döner. DocumentBuilder.MoveToXXX MoveToDocumentStart ve MoveToField gibi yöntemler. Sanal imleç, yöntemleri Write, Writeln, InsertBreak ve diğerleri çağırdığınızda metin ekleneceği yeri gösterir. Sanal imleç hakkında daha fazla bilgi edinmek için “İmleçle gezinme” başlıklı bu makaleyi okuyun.
Aşağıdaki kod örneği bir yer imine nasıl gideceğinizi gösterir:
Belge Oluşturma ve Düzenleme
Aspose.Words API belgeleri çeşitli öğeleri biçimlendirmekten sorumlu olan birden çok sınıf sağlar. Her sınıf, metin, paragraf, bölüm ve diğerleri gibi belirli bir belge öğesiyle ilişkili biçimlendirme özelliklerini kapsüller. Örneğin, Font sınıfı karakter biçimlendirme özelliklerini temsil eder, ParagraphFormat sınıfı paragraf biçimlendirme özelliklerini temsil eder vb. Bu sınıfların nesneleri ilgili DocumentBuilder özellikleri tarafından döndürülür ve sınıf adlarıyla aynı isimler verir. Bu nedenle onlara erişebilir ve belge oluşturma sırasında istediğiniz biçimi ayarlayabilirsiniz.
Metin, onay kutusları, Ole nesnesi, resimler, yer imleri, form alanları ve başka belge öğelerini imleç pozisyonuna Write yöntemi veya herhangi bir DocumentBuilder.InsertXXX yöntemlerinden biri, örneğin InsertField, InsertHtml, ve benzer yöntemlerle ekleyebilirsiniz.
basit bir belge oluşturmak için nasıl bir DocumentBuilder kullanacağımızı görelim.
DocumentBuilder kullanarak bir belge oluşturun
Başlamak için bir DocumentBuilder oluşturmanız ve onu bir Document nesnesiyle ilişkilendirmeniz gerekiyor. Bir DocumentBuilder yeni örneği çağırarak ve onu bir Document nesnesine ekleyerek oluşturursunuz.
Bir metin eklemek için, metni belgenin içine yerleştirmek istediğiniz dizeyi Write yöntemine geçirin.
Aşağıdaki kod örneği bir belge oluşturma nasıl yapılacağını gösterir bir belge oluşturucu kullanarak.
Belge Biçimlendirmeyi Belirt
1 Font özelliği metin biçimlendirmesini tanımlar. Bu nesne farklı yazı tipi öznitelikleri içerir (yazı tipi adı, yazı tipi boyutu, renk vb.). Bazı önemli yazı tipi öznitelikleri ayrıca doğrudan erişmek için size izin veren DocumentBuilder özelliklerinde de temsil edilir. Bunlar Font.Bold, Font.Italic ve Font.Underline Boolean özellikleri.
Aşağıdaki kod örneği, biçimlendirilmiş metin eklemek için DocumentBuilder‘i nasıl kullanacağınızı gösterir
- Font belgenin geçerli konumundan itibaren tüm metinlere uygulanacak karakter biçimlendirmesini belirtir.
- ParagraphFormat geçerli paragrafı ve tüm gelecek paragrafları oluşturmak için paragraf biçimlendirmesini belirtir.
- PageSetup geçerli bölümün ve eklenen tüm bölümlerin sayfa ve bölüm özelliklerini belirtir.
- CellFormat ve RowFormat, belgenin mevcut konumundan itibaren tablo hücreleri ve satırlarına uygulanacak biçimlendirme özelliklerini belirtir.
Bu durumda “geçerli” demek imlecin bulunduğu konumu, paragrafı, bölümü, hücreyi ya da satırı ifade eder.