Bölümlerle Çalışmak
Bazen tüm sayfalarda aynı biçimlendirmeye sahip olmayan bir belge istersiniz. Örneğin, sayfa numarası biçimlerini değiştirmeniz, farklı sayfa boyutuna ve yönüne sahip olmanız veya ilk belge sayfasını numaralandırmadan kapak sayfası olarak almanı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üğümlerdir.
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 biçimlendirme değişiklikleri yapmanıza olanak tanır. Aspose.Words üstbilgi ve altbilgi, sayfa yapısı 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ı ile 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ı tarafından temsil edilir. Section nesneleri Document düğümünün hemen alt öğeleridir ve Sections özelliği aracılığıyla erişilebilir. Bu düğümleri aşağıdaki gibi bazı yöntemler kullanarak yönetebilirsiniz Remove, Add, IndexOf, ve diğerleri.
Bölüm sonu, belge sayfalarını özelleştirilebilir düzenlere sahip 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:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
SectionStart numaralandırmasını yalnızca aşağıdaki gibi ilk bölüm için geçerli olan bir kesme türü seçmek için de kullanabilirsiniz NewColumn, NewPage, EvenPage, ve OddPage.
Bir Bölümü Yönetme
Bir bölüm normal bir bileşik düğüm olduğundan, tüm düğüm manipülasyonu API bölümleri işlemek için kullanılabilir: bölümler üzerinde ekleme, kaldırma ve diğer işlemler. Düğümler hakkında daha fazla bilgiyi makalede okuyabilirsiniz Aspose.Words Belge Nesne Modeli (DOM).
Öte yandan, bölümlerle çalışmak için DocumentBuilder API ‘i de kullanabilirsiniz. Bu yazıda, 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 bir bölüm sonu eklemenizi sağlar.
Aşağıdaki kod örneği, bir belgeye bölüm sonu 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 ve bunun yerine o bölümün içeriğini silmeniz gerekmiyorsa 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şıma
Belgenizdeki bir bölümü bir konumdan diğerine taşımak istiyorsanız, o bölümün dizinini almanız gerekir. Aspose.Words, SectionCollection ‘den bir bölüm pozisyonu 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 öğelerinde 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 kılavuzunun türünü belirtmek isterseniz, SectionLayoutMode numaralandırmasını kullanarak bir bölüm düzeni modu seçebilirsiniz:
- Varsayılan
- Izgara
- LineGrid
- SnapToChars
Aşağıdaki kod örneği, her sayfanın sahip olabileceği satır sayısını nasıl sınırlayacağınızı gösterir:
Bir Bölümü Düzenleme
Belgenize yeni bir bölüm eklediğinizde, düzenleyebileceğiniz bir gövde veya paragraf olmayacaktır. Aspose.Words, bir bölümün EnsureMinimum yöntemini kullanarak en az bir paragraf içeren bir gövde içerdiğini garanti etmenizi sağlar – belgeye otomatik olarak bir Gövde (veya HeaderFooter) düğümü ekler ve ardından ona bir Paragraf ekler.
Aşağıdaki kod örneği, EnsureMinimum kullanarak yeni bir bölüm düğümünün nasıl hazırlanacağını gösterir:
İçerik Ekleme veya Ekleme
Bir bölümün başına / sonuna bir ş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, varolan 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 bir 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, çok sayıda 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ındaki bölümleri kopyalamanıza izin verir.
Aşağıdaki kod örneği, belgeler arasında bölümlerin nasıl kopyalanacağını gösterir:
Bölüm Üstbilgisi ve Altbilgisi ile çalışın
Her bölüm için bir üstbilgi veya altbilgi görüntülemenin temel kuralları oldukça basittir:
- Bölümün belirli bir türde kendi üstbilgileri / altbilgileri 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 – devre dışı bırakılırlarsa bölümün kendi başlıkları yok sayılır.
Aşağıdaki kod örneği, farklı başlıklara sahip 2 bölümlerin nasıl oluşturulacağını gösterir:
Belgenizdeki HeaderFooter nesneleri kaldırmadan üstbilgi ve altbilgi metnini 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 üstbilgi altbilgilerinden 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 belgenin tamamının boyutunu ve düzenini özelleştirmek ve değiştirmek isteyebilirsiniz. Sayfa yapısı ile, farklı ilk sayfaları veya tek sayfaları yazdırmak için kenar boşlukları, yönlendirme ve boyut gibi belge sayfalarının 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ümlerdeki sayfa özelliklerinin nasıl değiştirileceğini gösterir: