Bölümlerle Çalışma
Bazen tüm sayfalarda aynı biçimlendirme olmayan bir belge istiyorsunuz. Örneğin, sayfa numaralarını değiştirmek, farklı sayfa boyutları ve yönlendirmeleri veya herhangi bir numaralandırma olmadan ilk belgeyi kapak sayfası olarak kullanmak gibi ihtiyaçlarınız olabilir. Bölümler aracılığıyla bunu başarabilirsiniz.
Bölümleri, başlıkları ve altbilgileri, yönlendirmeyi, sütunları, kenar boşluklarını, sayfa numaralandırma biçimlendirmesini ve diğerleri kontrol eden seviye düğümleri.
Aspose.Words size belgenin bölümlerini yönetme, bir belgeyi bölümlere ayırma ve yalnızca belirli bir bölüme uygulanacak biçimlendirme değişiklikleri yapma imkanı sağlar. Aspose.Words başlıklar ve alt yazı, sayfa düzeni ve sütun ayarları gibi bölüm biçimi hakkında bilgi depolar.
Bu makale bölümler ile bölüm aramalarıyla nasıl çalıştığını açıklar.
Neyin Bölüm ve Bölüm Kesme
Belge bölümleri Section ve SectionCollection sınıfları tarafından temsil edilir. Bölüm nesneleri, Document düğümüne bağlı doğrudan çocuklardır ve Sections özelliği aracılığıyla erişilebilir. Bu düğümleri Remove, Add, IndexOf gibi bazı yöntemler kullanarak yönetebilirsiniz.
Bölüm araması, belgenin sayfalarını özelleştirilebilir düzenlerle bölümler halinde bölen bir seçenektir.
Bir Bölüm Kesintisinin Türleri
Aspose.Words size BreakType numaralandırma türündeki farklı bölüm kesintileriyle belgeleri bölme ve biçimlendirme imkanı sunar:
-SectionBreakContinuous
- SectionBreakNewColumn -SectionBreakNewPage
- SectionBreakEvenPage -SectionBreakOddPage
YeniSütun, YeniSayfa, EşittirSayfa ve ZıtSayfa gibi yalnızca ilk bölüm için geçerli olan bir kesme türü seçmek için SectionStart numaralandırmayı da kullanabilirsiniz.
Bir Bölümü Yönet
Çünkü bölüm bir normal bileşik düğüm, tüm düğüm manipülasyonu API bölümlerin manipüle edilmesi için kullanılabilir: ekleme, kaldırma ve diğer bölümler üzerindeki işlemler. Düğümler hakkında daha fazla bilgi için makaleyi Aspose.Words Document Object Model (DOM) okuyabilirsiniz.
Öte yandan, bölümlere çalışmak için de DocumentBuilder API kullanabilirsiniz. Bu makaledeki odak nokta bu özel bölüm çalışma şekli olacaktır.
Bir Bölüm Boşluğu Ekle veya Kaldır
1 InsertBreak‘ı kullanarak metne bir bölüm kırma eklemenizi sağlayan Aspose.Words’i tanımlar.
Aşağıdaki kod örneği bir belgenin içine bir bölüm kesintisi eklemeyi gösterir:
Bir bölme kırıklığını silmek için Remove yöntemini kullanın. Belirli bir bölme kırıklığını kaldırmanız gerekmiyorsa ve bunun yerine bu bölümün içeriğini silmeniz gerekiyorsa ClearContent yöntemini kullanabilirsiniz.
Aşağıdaki kod örneği, nasıl bölüm kesintileri kaldırılacağını gösterir:
Bir Bölümü Taşı
Bir belge içinde bir bölümden başka bir konuma taşımak istiyorsanız, o bölümün dizinini almanız gerekir. Aspose.Words size bir SectionCollection içindeki bir bölüm pozisyonunu almanıza olanak tanır. Bir belgenizdeki tüm bölümleri almak için Sections özelliğini kullanabilirsiniz. Ancak sadece ilk bölümü almak istiyorsanız, FirstSection özelliğini kullanabilirsiniz.
Aşağıdaki kod örneği ilk bölüme erişmeyi ve bir bileşik düğümün çocuklarını yinelemeyi gösterir:
Bir Bölüm Düzeni Belirt
Bazen belgenizin farklı bölümlerini yaratıcı düzenler yaparak daha iyi görünmesini istiyorsunuz. Mevcut bölüm kılavuzunun türünü belirtmek istiyorsanız, SectionLayoutMode numaralandırmasından bir bölüm düzeni modu seçebilirsiniz:
- Varsayılan
- Kılavuz
- LineGrid -SnapToChars
Aşağıdaki kod örneğinde her sayfanın sahip olabileceği satır sayısını nasıl sınırlayacağınız gösterilmektedir:
[Bir bölümü düzenleme]
Bir belgeye yeni bir bölüm eklediğinizde, düzenleyebileceğiniz herhangi bir gövde veya paragraf olmayacak. Aspose.Words’i kullanarak, EnsureMinimum yöntemiyle bölümün en az bir paragraf içeren bir gövdesi olduğundan emin olmanıza izin verir – bunu belgenin üzerine otomatik olarak bir Gövde (veya BaşlıkAltBilgi) düğümü ekler ve sonra buna bir Paragraf ekler.
Aşağıdaki kod örneği, EnsureMinimum kullanarak yeni bir bölüm düğümü hazırlamayı gösterir
İçeriği Ekle veya Ön ekle
Bir şekil çizmek veya bir bölümün başına / sonuna metin veya görüntü eklemek istiyorsanız, AppendContent ve PrependContent yöntemlerini Section sınıfını kullanabilirsiniz.
Aşağıdaki kod örneğinde mevcut bir bölümün içeriğini nasıl ekleyeceğinizi gösterir:
Bir Bölümü Kopyala
Aspose.Words size, deepClone yöntemi kullanılarak tam bir kopyasını oluşturarak bir bölümü çoğaltmanıza izin verir.
Aşağıdaki kod örneği belgenizdeki ilk bölümün nasıl klonlanacağını göstermektedir:
Belgeler Arasında Bölümleri Kopyala
Bazı durumlarda büyük belgeler ile birçok bölümünüz olabilir ve bir belgeden diğerine bir bölümün içeriğini kopyalamak isteyebilirsiniz.
Aspose.Words belgeleri arasında bölümler kopyalamak için kullanılan ImportNode yöntemi ile size izin verir.
Aşağıdaki kod örneği, belgelar arasında bölümler nasıl kopyalanacağını göstermektedir:
Bölüm Başlığı ve Altbilgisi ile Çalışın
Her bölüm için bir başlık veya altbilgi görüntülemek için temel kurallar oldukça basittir:
- Eğer bölüm kendi başına belirli bir tür başlık / altbilgiye sahip değilse, o zaman önceki bölümden alınır.
- Sayfanın başlık/altbilgisinin görünümü “Farklı İlk Sayfa” ve “Farklı Tek ve Çift Sayfalar” bölüm ayarları tarafından kontrol edilir – eğer bunlar devre dışı bırakılırsa, bölümün kendi başlıkları göz ardı edilir.
Aşağıdaki kod örneğinde farklı başlıklar ile iki bölüm oluşturmayı gösterir:
Başlık ve altbilgileri kaldırmak istiyorsanız ancak HeaderFooter nesnenizi belgenizden kaldırmayın, bunu yapmak için ClearHeadersFooters yöntemini kullanabilirsiniz. Ayrıca, tüm şekilleri başlıklardan ve altbilgilerden kaldırmak için DeleteHeaderFooterShapes yöntemini de kullanabilirsiniz.
Aşağıdaki kod örneği, bir bölümdeki tüm başlıkların ve altbilgilerin içeriğini temizlemek için nasıl yapılacağını göstermektedir:
Aşağıdaki kod örneği bir bölümdeki tüm başlıklardan ve altbilgilerinden tüm şekillerin nasıl kaldırılacağını gösterir:
Bölgede Sayfa Özelliklerini Özelleştirin
Bir sayfayı ya da belgenin yazdırılmadan önce tek bir sayfanın ya da bütün belgenin boyutunu ve düzenini özelleştirmek ve değiştirmek isteyebilirsiniz. Sayfa Kurulumu ile, farklı ilk sayfalar veya tekil sayfalar için kenar boşlukları, yönlendirme ve boyut gibi belge sayfalarının ayarlarını değiştirebilirsiniz.
Aspose.Words size sayfa ve bölüm özelliklerini PageSetup sınıfı kullanarak özelleştirmenizi sağlar.
Aşağıdaki kod örneği, geçerli bölüme sayfa boyutu ve yönelim gibi özellikleri nasıl ayarlayacağını göstermektedir:
Aşağıdaki kod örneğinde tüm bölümlerde sayfa özelliklerini nasıl değiştireceğinizi gösterir: