Bölümlerle Çalışmak
Bazen tüm sayfalarda aynı biçimlendirmeye sahip olmayan bir belge istersiniz. Örneğin, sayfa numarası formatlarını değiştirmeniz, farklı sayfa boyutu ve yönüne sahip olmanız veya ilk belge sayfasını numaralandırma olmadan kapak sayfası olarak kullanmanız gerekebilir. Bunu bölümlerle başarabilirsiniz.
Bölümler, üstbilgileri ve altbilgileri, yönlendirmeyi, sütunları, kenar boşluklarını, sayfa numarası biçimlendirmesini ve diğerlerini kontrol eden düzey düğümleridir.
Aspose.Words, bölümleri yönetmenize, bir belgeyi bölümlere ayırmanıza ve yalnızca belirli bir bölüm için geçerli olan biçimlendirme değişiklikleri yapmanıza olanak tanır. Aspose.Words, üstbilgiler ve altbilgiler, sayfa düzeni ve sütun ayarları gibi bölüm biçimlendirmesi hakkındaki bilgileri bölüm sonunda saklar.
Bu makalede bölümler ve bölüm sonlarıyla nasıl çalışılacağı açıklanmaktadır.
Bölüm ve Bölüm Sonu Nedir?
Belge bölümleri Section ve SectionCollection sınıflarıyla temsil edilir. Bölüm nesneleri, Document düğümünün doğrudan alt öğeleridir ve bunlara Sections özelliği aracılığıyla erişilebilir. Bu düğümleri Remove, Add, IndexOf ve diğerleri gibi bazı yöntemleri kullanarak yönetebilirsiniz.
Bölüm sonu, belge sayfalarını özelleştirilebilir düzenlerle bölümlere ayıran bir seçenektir.
Bölüm Sonu Türleri
Aspose.Words, BreakType numaralandırmasının farklı bölüm sonlarını kullanarak belgeleri bölmenize ve biçimlendirmenize olanak tanır:
- BölümBreakSürekli
- BölümBreakNewColumn
- BölümBreakNewPage
- BölümBreakEvenPage
- BölümBreakOddPage
NewColumn, NewPage, EvenPage ve OddPage gibi yalnızca ilk bölüm için geçerli olan bir kesme türü seçmek için SectionStart numaralandırmasını da kullanabilirsiniz.
Bir Bölümü Yönetme
Bir bölüm normal bir bileşik düğüm olduğundan, API düğüm manipülasyonunun tamamı bölümleri değiştirmek için kullanılabilir: bölümler eklemek, kaldırmak ve bölümler üzerindeki diğer işlemler için. Düğümler hakkında daha fazla bilgiyi Aspose.Words Document Object Model (DOM) makalesinde okuyabilirsiniz.
Öte yandan bölümlerle çalışmak için DocumentBuilder API’yi de kullanabilirsiniz. Bu makalede bölümlerle çalışmanın bu özel yoluna odaklanacağız.
Bölüm Sonu Ekleme veya Kaldırma
Aspose.Words, InsertBreak yöntemini kullanarak metne bölüm sonu eklemenizi sağlar.
Aşağıdaki kod örneği, bir belgeye bölüm sonunun nasıl ekleneceğini gösterir:
Bölüm sonunu silmek için Remove yöntemini kullanın. Belirli bir bölüm sonunu kaldırmanız gerekmiyor ve bunun yerine o bölümün içeriğini silmek istiyorsanız ClearContent yöntemini kullanabilirsiniz.
Aşağıdaki kod örneği bölüm sonlarının nasıl kaldırılacağını gösterir:
Bir Bölümü Taşı
Belgenizde bir bölümü bir konumdan diğerine taşımak istiyorsanız o bölümün dizinini almanız gerekir. Aspose.Words, Item özelliğini kullanarak SectionCollection‘den bölüm konumu almanızı sağlar. Belgenizdeki tüm bölümleri almak için Sections özelliğini kullanabilirsiniz. Ancak yalnızca ilk bölümü almak istiyorsanız FirstSection özelliğini kullanabilirsiniz.
Aşağıdaki kod örneği, ilk bölüme nasıl erişileceğini ve bileşik düğümün alt öğelerinin nasıl yineleneceğini gösterir:
Bir Bölüm Düzeni Belirtin
Bazen farklı belge bölümleri için yaratıcı düzenler oluşturarak belgenizin daha iyi görünmesini istersiniz. Geçerli bölüm ızgarasının türünü belirtmek istiyorsanız SectionLayoutMode numaralandırmasını kullanarak bir bölüm düzeni modu seçebilirsiniz:
- Varsayılan
- Kafes
- Çizgi Izgarası
- SnapToChar’lar
Aşağıdaki kod örneği, her sayfanın sahip olabileceği satır sayısının nasıl sınırlandırılacağını gösterir:
Bir Bölümü Düzenleme
Belgenize yeni bir bölüm eklediğinizde düzenleyebileceğiniz herhangi bir gövde veya paragraf olmayacaktır. Aspose.Words, EnsureMinimum yöntemini kullanarak bir bölümün en az bir paragraf içeren bir gövde içerdiğini garanti etmenize olanak tanır; belgeye otomatik olarak bir Gövde (veya HeaderFooter) düğümü ekleyecek ve ardından ona bir Paragraf ekleyecektir.
Aşağıdaki kod örneği, EnsureMinimum kullanarak yeni bir bölüm düğümünün nasıl hazırlanacağını gösterir:
İçeriği Ekle veya Başına Ekle
Bir bölümün başına/sonuna şekil çizmek veya metin veya resim eklemek istiyorsanız Section sınıfının AppendContent ve PrependContent yöntemlerini kullanabilirsiniz.
Aşağıdaki kod örneği, mevcut bir bölümün içeriğinin nasıl ekleneceğini gösterir:
Bir Bölümü Klonla
Aspose.Words, Clone yöntemini kullanarak bir bölümün tam kopyasını oluşturarak bir bölümü çoğaltmanıza olanak tanır.
Aşağıdaki kod örneği, belgenizdeki ilk bölümün nasıl kopyalanacağını gösterir:
Belgeler Arasında Bölümleri Kopyalama
Bazı durumlarda, birçok bölümü olan büyük belgeleriniz olabilir ve bir bölümün içeriğini bir belgeden diğerine kopyalamak isteyebilirsiniz.
Aspose.Words, ImportNode yöntemini kullanarak belgeler arasında bölümleri kopyalamanıza olanak tanır.
Aşağıdaki kod örneği, bölümlerin belgeler arasında nasıl kopyalanacağını gösterir:
Bölüm Üstbilgisi ve Altbilgisiyle Çalışma
Her bölüm için üstbilgi veya altbilgiyi görüntülemeye ilişkin temel kurallar oldukça basittir:
- Bölümün belirli bir türde kendi üstbilgisi/altbilgisi yoksa önceki bölümden alınır.
- Sayfada görüntülenen üstbilgi/altbilgi türü, “Farklı İlk Sayfa” ve “Farklı Tek ve Çift Sayfalar” bölüm ayarları tarafından kontrol edilir; bunlar devre dışı bırakılırsa bölümün kendi başlıkları göz ardı edilir.
Aşağıdaki kod örneği, farklı başlıklara sahip 2 bölümün nasıl oluşturulacağını gösterir:
Belgenizdeki HeaderFooter nesnelerini kaldırmadan üst bilgi ve alt bilgi metinlerini kaldırmak istiyorsanız ClearHeadersFooters yöntemini kullanabilirsiniz. Ayrıca belgenizdeki üstbilgi ve altbilgilerdeki tüm şekilleri kaldırmak için DeleteHeaderFooterShapes yöntemini kullanabilirsiniz.
Aşağıdaki kod örneği, bir bölümdeki tüm üstbilgi ve altbilgilerin içeriğinin nasıl temizleneceğini gösterir:
Aşağıdaki kod örneği, bir bölümdeki tüm üst bilgi alt bilgilerinden tüm şekillerin nasıl kaldırılacağı:
Bir Bölümdeki Sayfa Özelliklerini Özelleştirme
Bir sayfayı veya belgeyi yazdırmadan önce, tek bir sayfanın veya tüm belgenin boyutunu ve düzenini özelleştirmek ve değiştirmek isteyebilirsiniz. Sayfa düzeni ile, farklı ilk sayfaları veya tek sayfaları yazdırmak için belge sayfalarının kenar boşlukları, yön ve boyut gibi ayarlarını değiştirebilirsiniz.
Aspose.Words, PageSetup sınıfını kullanarak sayfa ve bölüm özelliklerini özelleştirmenize olanak tanır.
Aşağıdaki kod örneği, geçerli bölüm için sayfa boyutu ve yönlendirme gibi özelliklerin nasıl ayarlanacağını gösterir:
Aşağıdaki kod örneği, tüm bölümlerde sayfa özelliklerinin nasıl değiştirileceğini gösterir: