Belge Oluşturucuya Genel Bakış
DocumentBuilder, Document ile ilişkilendirilen ve sıfırdan dinamik belgeler oluşturmanıza veya mevcut bir belgeye yeni öğeler eklemenize olanak tanıyan güçlü bir sınıftır.
DocumentBuilder
Belge Oluşturucu veya Aspose.Words DOM
DocumentBuilder
DocumentBuilder ile mümkün olan işlemler, Aspose.Words DOM 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 kullanmaktan daha fazla kod satırı gerektirir.
Belge Gezintisi
Belge gezintisi, MoveToDocumentStart ve MoveToField gibi çeşitli DocumentBuilder.MoveToXXX yöntemleri kullanarak belgedeki başka bir konuma taşıyabileceğiniz sanal imleç kavramına dayanır. Bu sanal imleç, yöntemleri çağırırken metnin nereye ekleneceğini gösterir Write, Writeln, InsertBreak, ve diğerleri.
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 öğelerini biçimlendirmekten sorumlu birkaç sınıf 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 kapsüller. Ö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 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.
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 öğelerini de ekleyebilirsiniz.
DocumentBuilder kullanarak basit bir belgenin nasıl oluşturulacağını görelim.
DocumentBuilder kullanarak Belge oluşturma
Başlamak için bir DocumentBuilder oluşturmanız ve onu bir Document nesnesiyle ilişkilendirmeniz gerekir. Oluşturucusunu çağırarak yeni bir DocumentBuilder örneği oluşturur ve oluşturucuya eklenmek üzere onu bir Document nesnesine iletirsiniz.
Bir metin eklemek için belgeye eklemeniz gereken metin dizesini Write yöntemine geçirin.
Aşağıdaki kod örneği, belge oluşturucuyu 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 öznitelikleri (yazı tipi adı, yazı tipi boyutu, renk vb.) İçerir. Bazı önemli yazı tipi öznitelikleri, bunlara doğrudan erişmenize izin vermek için DocumentBuilder özellikleriyle de temsil edilir. Bunlar Font.Bold, Font.Italic ve Font.Underline boolean ö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 biçimlendirmesini belirtir.
- ParagraphFormat geçerli ve eklenecek tüm paragraflar için paragraf biçimlendirmesini belirtir.
- PageSetup geçerli bölümün ve eklenecek bölümün tamamının 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 belirtin.
Bu durumda, “geçerli” imlecin bulunduğu konum, paragraf, bölüm, hücre veya satır anlamına gelir.