Bir Belgeyi Kolayca Değiştirmek için `DocumentBuilder` kullanma

Biçimlendirme Belirtme

Yazı Tipi Biçimlendirme

Geçerli yazı tipi biçimlendirmesi, DocumentBuilder.Font özelliği tarafından döndürülen bir Font nesnesiyle temsil edilir. Font sınıfı, Microsoft Word ‘de mümkün olan çok çeşitli yazı tipi özelliklerini içerir. Aşağıdaki örnek, yazı tipi biçimlendirmesinin nasıl ayarlanacağını gösterir.

Paragraf Biçimlendirme

Geçerli paragraf biçimlendirmesi, DocumentBuilder.ParagraphFormat özelliği tarafından döndürülen bir ParagraphFormat nesnesiyle temsil edilir. Bu nesne Microsoft Word içinde bulunan çeşitli paragraf biçimlendirme özelliklerini kapsüller. Paragraf biçimlendirmesini varsayılan olarak Normal stile, sola hizalı, girinti yok, boşluk yok, kenarlık yok ve gölgeleme yok olarak ParagraphFormat.ClearFormatting ‘i arayarak kolayca sıfırlayabilirsiniz. Aşağıdaki örnekte paragraf biçimlendirmesinin nasıl ayarlanacağı gösterilmektedir.

Asya Tipografisi ile Çalışmak

Asya ve Latin metinleri, Sayılar arasındaki Boşluğu otomatik olarak ayarlayın

Hem Doğu Asya hem de Latin metni içeren bir şablon tasarlıyorsanız ve her iki metin türü arasındaki boşlukları denetleyerek form şablonunun görünümünü geliştirmek istiyorsanız, form şablonunuzu bu iki metin türü arasındaki boşlukları otomatik olarak ayarlayacak şekilde yapılandırabilirsiniz. Bunu başarmak için ParagraphFormat sınıfının AddSpaceBetweenFarEastAndAlpha ve AddSpaceBetweenFarEastAndDigit özelliklerini kullanabilirsiniz.

Aşağıdaki kod örneği, ParagraphFormat.AddSpaceBetweenFarEastAndAlpha ve ParagraphFormat.AddSpaceBetweenFarEastAndDigit özelliklerinin nasıl kullanılacağını gösterir.

Asya Paragraf Aralığını ve Girintilerini Değiştirme

Aşağıdaki kod örneği, Asya paragraf aralığı ve girintiler nasıl değiştirileceğini gösterir.

Satır Sonu Seçeneklerini Ayarlama

MS Word’deki Paragraph özellikler iletişim kutusunun Asya Tipografisi sekmesinde satır sonu grubu bulunur. Bu grubun seçenekleri kullanılarak ayarlanabilir FarEastLineBreakControl, WordWrap, HangingPunctuation ParagraphFormat sınıfının özellikleri. Below code örneği bu özelliklerin nasıl kullanılacağını gösterir.

Hücre Biçimlendirme

Bir tablonun oluşturulması sırasında hücre biçimlendirmesi kullanılır. DocumentBuilder.CellFormat özelliği tarafından döndürülen bir CellFormat nesnesiyle temsil edilir. CellFormat genişlik veya dikey hizalama gibi çeşitli tablo hücresi özelliklerini kapsüller. Aşağıdaki örnek, biçimlendirilmiş tek bir hücre içeren bir tablonun nasıl oluşturulacağını gösterir.

Satır Biçimlendirme

Geçerli satır biçimlendirmesi, DocumentBuilder.RowFormat özelliği tarafından döndürülen bir RowFormat nesnesi tarafından belirlenir. Nesne, tüm tablo satırı biçimlendirmesi hakkındaki bilgileri kapsüller. Aşağıdaki örnekte, tek bir hücre içeren bir tablonun nasıl oluşturulacağı ve satır biçimlendirmesinin nasıl uygulanacağı gösterilmektedir.

Liste Biçimlendirme

Aspose.Words liste biçimlendirmesi uygulayarak listelerin kolayca oluşturulmasını sağlar. DocumentBuilder, bir ListFormat nesnesi döndüren DocumentBuilder.ListFormat özelliğini sağlar. Bu nesnenin bir listeyi başlatmak ve bitirmek ve girintiyi artırmak / azaltmak için çeşitli yöntemleri vardır. Microsoft Word’de iki genel liste türü vardır: madde işaretli ve numaralandırılmış.

• Madde işaretli bir liste başlatmak için ListFormat.ApplyBulletDefault öğesini arayın.
• Numaralandırılmış bir liste başlatmak için ListFormat.ApplyNumberDefault öğesini arayın.

Madde işareti veya sayı ve biçimlendirme geçerli paragrafa eklenir ve madde işaretli liste biçimlendirmesini durdurmak için ListFormat.RemoveNumbers çağrılana kadar DocumentBuilder kullanılarak oluşturulan diğer tüm paragraflar çağrılır. Word belgelerinde listeler en fazla dokuz düzeyden oluşabilir. Her seviye için liste biçimlendirmesi, hangi madde işaretinin veya numaranın kullanıldığını, sol girintiyi, madde işareti ile metin arasındaki boşluğu vb. Belirtir.

• Geçerli paragrafın liste düzeyini bir düzey artırmak için ListFormat.ListIndent öğesini arayın.
• Geçerli paragrafın liste düzeyini bir düzey azaltmak için ListFormat.ListOutdent öğesini arayın.

Yöntemler liste düzeyini değiştirir ve yeni düzeyin biçimlendirme özelliklerini uygular.

Paragrafın liste düzeyini almak veya ayarlamak için ListFormat.ListLevelNumber özelliğini de kullanabilirsiniz. Liste seviyeleri 0 ile 8 arasında numaralandırılmıştır.

Aşağıdaki örnek, çok düzeyli bir listenin nasıl oluşturulacağını gösterir.

Sayfa Yapısı ve Bölüm Biçimlendirme

Sayfa yapısı ve bölüm özellikleri, DocumentBuilder.PageSetup özelliği tarafından döndürülen PageSetup nesnesinde kapsüllenir. Nesne, bir bölümün tüm sayfa yapısı özniteliklerini (sol kenar boşluğu, alt kenar boşluğu, kağıt boyutu vb.) Özellik olarak içerir. Aşağıdaki örnek, geçerli bölüm için sayfa boyutu ve yönlendirme gibi özelliklerin nasıl ayarlanacağını gösterir.

Stil Uygulama

Yazı Tipi veya ParagraphFormat gibi bazı biçimlendirme nesneleri stilleri destekler. Tek bir yerleşik veya kullanıcı tanımlı stil, stilin adı, temel stili, yazı tipi ve paragraf biçimlendirmesi gibi karşılık gelen stil özelliklerini içeren Style nesnesiyle temsil edilir.

Ayrıca, bir Style nesnesi, Style.StyleIdentifier numaralandırma değeriyle temsil edilen yerel ayardan bağımsız bir stil tanımlayıcısı döndüren Style.StyleIdentifier özelliğini sağlar. Mesele şu ki, Microsoft Word içindeki yerleşik stillerin adları farklı diller için yerelleştirilmiştir. Bir stil tanımlayıcısı kullanarak, belge dilinden bağımsız olarak doğru stili bulabilirsiniz. Numaralandırma değerleri, Normal, Başlık 1, Başlık 2 vb. Gibi Microsoft Word yerleşik stillerine karşılık gelir. Tüm kullanıcı tanımlı stillere StyleIdentifier.User value atanır. Aşağıdaki örnekte paragraf stilinin nasıl uygulanacağı gösterilmektedir.

Kenarlıklar ve Gölgelendirme

Sınırlar BorderCollection ile temsil edilir. Bu, dizin veya kenarlık türüne göre erişilen Kenarlık nesneleri topluluğudur. Kenarlık türü BorderType numaralandırmasıyla temsil edilir. Numaralandırmanın bazı değerleri birden çok veya yalnızca bir belge öğesine uygulanabilir. Örneğin, BorderType.Bottom bir paragrafa veya tablo hücresine uygulanabilirken BorderType.DiagonalDown yalnızca bir tablo hücresindeki köşegen kenarlığı belirtir.

Hem kenarlık koleksiyonu hem de her ayrı kenarlık, renk, çizgi stili, çizgi genişliği, metinden uzaklık ve isteğe bağlı gölge gibi benzer özelliklere sahiptir. Aynı ismin özellikleri ile temsil edilirler. Özellik değerlerini birleştirerek farklı kenarlık türleri elde edebilirsiniz. Ayrıca, hem BorderCollection hem de Border nesneleri, Border.ClearFormatting yöntemini çağırarak bu değerleri varsayılana sıfırlamanıza izin verir. Kenarlık özellikleri varsayılan değerlere sıfırlandığında kenarlığın görünmez olduğunu unutmayın. Shading sınıfı, belge öğeleri için gölgelendirme öznitelikleri içerir. İstediğiniz gölgelendirme dokusunu ve öğenin arka planına ve ön planına uygulanan renkleri ayarlayabilirsiniz.

Gölgelendirme dokusu, Shading nesnesine çeşitli desenlerin uygulanmasına izin veren bir TextureIndex numaralandırma değeriyle ayarlanır. Örneğin, bir belge öğesinin arka plan rengini ayarlamak için TextureIndex.TextureSolid değerini kullanın ve ön plan gölgelendirme rengini uygun şekilde ayarlayın. Aşağıdaki örnek, bir paragrafa kenarlıkların ve gölgelendirmenin nasıl uygulanacağını gösterir.

Izgaraya Yapış

Aspose.Words paragraf özelliği ek bileşenini ızgaraya almak ve ayarlamak için ParagraphFormat.SnapToGrid ve Font.SnapToGrid olmak üzere iki özellik sağlar.

İmleci Hareket Ettirme

Geçerli İmleç Konumunu Algılama

Oluşturucunun imlecinin şu anda herhangi bir zamanda konumlandırıldığı yeri edinebilirsiniz. DocumentBuilder.CurrentNode özelliği, bu oluşturucuda seçili olan düğümü döndürür. Düğüm, bir paragrafın doğrudan bir alt öğesidir. DocumentBuilder kullanarak gerçekleştirdiğiniz tüm ekleme işlemleri DocumentBuilder.CurrentNode ‘dan önce eklenir. Geçerli paragraf boş olduğunda veya imleç paragrafın sonundan hemen önce konumlandırıldığında DocumentBuilder.CurrentNode null değerini döndürür.

Ayrıca, bu DocumentBuilder öğesinde seçili olan paragrafı alan DocumentBuilder.CurrentParagraph özelliğini de kullanabilirsiniz. Aşağıdaki örnek, belge oluşturucudaki geçerli düğüme nasıl erişileceğini gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Herhangi Bir Düğüme Geçme (Paragraflar ve Çocukları)

Paragraf veya paragrafın doğrudan alt öğesi olan bir belge nesnesi düğümünüz varsa, oluşturucunun imlecini bu düğüme yönlendirebilirsiniz. Bunu gerçekleştirmek için DocumentBuilder.MoveTo yöntemini kullanın. Aşağıdaki örnek, imleç konumunun belirli bir düğüme nasıl taşınacağını gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Belgenin Başlangıcına/Sonuna Gitme

Belgenin başına geçmeniz gerekiyorsa, DocumentBuilder.MoveToDocumentStart öğesini arayın. Belgenin sonuna gitmeniz gerekiyorsa, DocumentBuilder.MoveToDocumentEnd öğesini arayın. Aşağıdaki örnek, imleç konumunun belgenin başına veya sonuna nasıl taşınacağını gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Bir Bölüme Geçme

Birden çok bölüm içeren bir belgeyle çalışıyorsanız, DocumentBuilder.MoveToSection kullanarak istediğiniz bir bölüme geçebilirsiniz. Bu yöntem, imleci belirtilen bölümün başına taşır ve gerekli bölümün dizinini kabul eder. Bölüm dizini 0 ‘ten büyük veya ona eşit olduğunda, belgenin başından itibaren 0 ilk bölüm olacak şekilde bir dizin belirtir. Bölüm dizini 0 ‘ten küçük olduğunda, belgenin sonundan -1 son bölüm olacak şekilde bir dizin belirtir. Aşağıdaki örnek, bir imleç konumunun belirtilen bölüme nasıl taşınacağını gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Üstbilgi/ Altbilgiye Taşıma

Bir üstbilgi veya altbilgiye bazı veriler yerleştirmeniz gerektiğinde, önce DocumentBuilder.MoveToHeaderFooter kullanarak oraya gitmelisiniz. Yöntem, imlecin taşınması gereken üstbilgi veya altbilgi türünü tanımlayan bir HeaderFooterType numaralandırma değeri kabul eder. İlk sayfa için farklı üstbilgi ve altbilgi oluşturmak istiyorsanız, PageSetup.DifferentFirstPageHeaderFooter özelliğini true olarak ayarlamanız gerekir. Çift ve tek sayfalar için farklı üstbilgi ve altbilgi oluşturmak istiyorsanız, PageSetup.OddAndEvenPagesHeaderFooter öğesini true olarak ayarlamanız gerekir.

Ana hikayeye geri dönmeniz gerekiyorsa, üstbilgi veya altbilgiden çıkmak için DocumentBuilder.MoveToSection kullanın. Aşağıdaki örnek, DocumentBuilder kullanarak bir belgede üstbilgi ve altbilgi oluşturur.

Paragrafa Geçme

İmleci geçerli bölümde istediğiniz bir paragrafa taşımak için DocumentBuilder.MoveToParagraph kullanın. Bu yönteme iki parametre iletmelisiniz: paragraphIndex (taşınacak paragrafın dizini) ve characterIndex (paragrafın içindeki karakterin dizini).

Gezinme, geçerli bölümün geçerli hikayesinin içinde gerçekleştirilir. Diğer bir deyişle, imleci ilk bölümün birincil başlığına taşıdıysanız, paragraphIndex o bölümün başlığının içindeki paragrafın dizinini belirtir.

ParagraphIndex, 0 ‘ten büyük veya ona eşit olduğunda, bölümün başından itibaren 0 ilk paragraf olacak şekilde bir dizin belirtir. paragraphIndex, 0 ‘ten küçük olduğunda, bölümün sonundan -1 son paragraf olacak şekilde bir dizin belirtir.

Karakter dizini şu anda yalnızca paragrafın başına geçmek için 0 veya paragrafın sonuna gitmek için -1 olarak belirtilebilir. Aşağıdaki örnek, imleç konumunun belirtilen paragrafa nasıl taşınacağını gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Tablo Hücresine Taşıma

İmleci geçerli bölümdeki bir tablo hücresine taşımanız gerekiyorsa DocumentBuilder.MoveToCell kullanın. Bu yöntem dört parametreyi kabul eder:

• tableIndex - taşınacak tablonun dizini.
• rowIndex - tablodaki satırın dizini.
• columnIndex - tablodaki sütunun dizini.
• characterIndex - hücrenin içindeki karakterin dizini.

Gezinme, geçerli bölümün geçerli hikayesinin içinde gerçekleştirilir. Dizin parametreleri için, dizin 0 ‘den büyük veya ona eşit olduğunda, başlangıçtan itibaren 0 ilk öğe olacak şekilde bir dizin belirtir. Dizin 0 ‘den küçük olduğunda, son öğe olan -1 ile sondan bir dizin belirtir.

Ayrıca, şu anda characterIndex ‘nin hücrenin başına geçmek için yalnızca 0 veya hücrenin sonuna gitmek için -1 belirtebileceğini unutmayın. Aşağıdaki örnek, imleç konumunun belirtilen tablo hücresine nasıl taşınacağını gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Bir yer imine Taşıma

Yer imleri, belgede yeni öğelerin ekleneceği belirli yerleri işaretlemek için sıklıkla kullanılır. Bir yer imine gitmek için DocumentBuilder.MoveToBookmark kullanın. Bu yöntemin iki aşırı yükü vardır. En basit olanı, imlecin hareket ettirileceği yer iminin adından başka bir şey kabul etmez. Aşağıdaki örnek, imleç konumunun yer imine nasıl taşınacağını gösterir. Bu örneğin şablon dosyasını buradan indirebilirsiniz.

Bu aşırı yük, imleci, belirtilen ada sahip yer iminin başlamasından hemen sonra bir konuma taşır. Başka bir aşırı yük DocumentBuilder.MoveToBookmark imleci daha hassas bir şekilde bir yer imine taşır. İki ek boole parametresini kabul eder:

• isStart imlecin yer iminin başına mı yoksa sonuna mı taşınacağını belirler.
• isAfter imlecin yer imi başlangıç veya bitiş konumundan sonra mı yoksa yer imi başlangıç veya bitiş konumundan önce mi hareket ettirileceğini belirler.

Aşağıdaki örnek, imlecin konumunu yer iminin bitiminden hemen sonrasına nasıl taşıyacağınızı gösterir.

Her iki yöntem için karşılaştırma büyük /küçük harfe duyarlı değildir.

Bu şekilde yeni metin eklemek, yer iminin mevcut metninin yerini almaz. Belgedeki bazı yer imlerinin form alanlarına atandığını unutmayın. Böyle bir yer imine geçmek ve oraya metin eklemek, metni form alanı koduna ekler. Bu, form alanını geçersiz kılmayacak olsa da, eklenen metin alan kodunun bir parçası haline geldiği için görünmez.

Ölçü Birimleri Arasında Dönüştürme

Bazı ölçümleri (genişlik / yükseklik, kenar boşlukları ve çeşitli mesafeler) temsil eden Aspose.Words API ‘te sağlanan nesne özelliklerinin çoğu nokta cinsinden değerleri kabul eder (1 inç 72 noktaya eşittir). Bazen bu uygun değildir, bu nedenle çeşitli ölçüm birimleri arasında dönüşüm yapmak için yardımcı işlevler sağlayan ConvertUtil sınıfı vardır. İnçleri noktalara, noktaları inçlere, pikselleri noktalara ve noktaları piksellere dönüştürmeye izin verir. Pikseller noktalara dönüştürüldüğünde veya tersi olduğunda, 96 dpi (inç başına nokta) çözünürlüklerde veya belirtilen dpı çözünürlüğünde gerçekleştirilebilir. ConvertUtil