Alan Ekle
Bir belgeye alan eklemenin birkaç farklı yolu vardır:
*DocumentBuilder kullanarak *FieldBuilder kullanarak *Aspose.Words Document Object Model (DOM) kullanarak
Bu yazıda her bir yolu daha ayrıntılı olarak ele alacağız ve bu seçenekleri kullanarak belirli alanların nasıl ekleneceğini analiz edeceğiz.
DocumentBuilder’ı Kullanarak Bir Belgeye Alan Ekleme
Aspose.Words’te, bir belgeye yeni alanlar eklemek için InsertField yöntemi kullanılır. İlk parametre eklenecek alanın tam alan kodunu kabul eder. İkinci parametre isteğe bağlıdır ve alanın saha sonucunun manuel olarak ayarlanmasına olanak sağlar. Bu sağlanmazsa alan otomatik olarak güncellenir. Boş alan değerine sahip bir alan eklemek için bu parametreye null veya empty değerini iletebilirsiniz. Belirli alan kodu sözdiziminden emin değilseniz, önce alanı Microsoft Word’de oluşturun ve alan kodunu görmek için geçiş yapın.
Aşağıdaki kod örneği, DocumentBuilder kullanarak bir belgeye birleştirme alanının nasıl ekleneceğini gösterir:
Aynı teknik, diğer alanların içine yerleştirilmiş alanları eklemek için de kullanılır.
Aşağıdaki kod örneği, DocumentBuilder kullanarak başka bir alanın içine yerleştirilmiş alanların nasıl ekleneceğini gösterir:
Alan Düzeyinde Yerel Ayarı Belirtin
Dil tanımlayıcısı, bir ülke veya coğrafi bölgedeki dilin standart uluslararası sayısal kısaltmasıdır. Aspose.Words ile, alanın yerel ayar kimliğini alan veya ayarlayan LocaleId özelliğini kullanarak Yerel Ayarı alan düzeyinde belirleyebilirsiniz.
Aşağıdaki kod örneği bu seçeneğin nasıl kullanılacağını gösterir:
Yazılmamış/Boş Alan Ekle
Tıpkı Microsoft Word’nin izin verdiği gibi yazılmamış/boş alanlar ({}) eklemek istiyorsanız FieldType.FieldNone parametresi ile InsertField yöntemini kullanabilirsiniz. Word belgesine alan eklemek için “Ctrl + F9” tuş kombinasyonuna basabilirsiniz.
Aşağıdaki kod örneği, belgeye nasıl boş alan ekleneceğini gösterir:
FieldBuilder’ı Kullanarak Belgeye Alan Ekleme
Aspose.Words’e alan eklemenin alternatif yolu FieldBuilder sınıfıdır. Alan anahtarlarını ve argüman değerlerini metin, düğümler ve hatta iç içe geçmiş alanlar olarak belirlemek için akıcı bir arayüz sağlar.
Aşağıdaki kod örneği, FieldBuilder kullanarak bir belgeye nasıl alan ekleneceğini gösterir:
DOM Kullanarak Alan Ekleme
Aspose.Words Document Object Model (DOM)‘i kullanarak çeşitli alan türlerini de ekleyebilirsiniz. Bu bölümde birkaç örneğe bakacağız.
DOM kullanarak Birleştirme Alanını Belgeye Ekleme
Word belgesindeki MERGEFIELD alanı FieldMergeField sınıfıyla temsil edilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldMergeField sınıfını kullanabilirsiniz:
- birleştirme alanının adını belirtin
- birleştirme alanının formatını belirtin
- alan ayırıcı ile birleştirme alanının alan sonu arasındaki metni belirtin
- alan boş değilse birleştirme alanından sonra eklenecek metni belirtin
- alan boş değilse birleştirme alanından önce eklenecek metni belirtin
Aşağıdaki kod örneği, DOM kullanarak MERGE alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir:
Mail Merge ADDRESSBLOCK alanını DOM kullanarak bir Belgeye ekleme
ADDRESSBLOCK alanı, Word belgesine Mail Merge adres bloğu eklemek için kullanılır. Word belgesindeki ADDRESSBLOCK alanı FieldAddressBlock sınıfıyla temsil edilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAddressBlock sınıfını kullanabilirsiniz:
- alana ülke/bölge adının dahil edilip edilmeyeceğini belirtin
- adresin POST*CODE (Universal Postal Union 2006) tarafından tanımlandığı şekilde alıcının ülkesine/bölgesine göre biçimlendirilip biçimlendirilmeyeceğini belirtin
- hariç tutulan ülke/bölge adını belirtin
- adı ve adres biçimini belirtin
- adresi biçimlendirmek için kullanılan dil kimliğini belirtin
Aşağıdaki kod örneği, DOM kullanarak Mail Merge ADDRESSBLOCK Alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir:
DocumentBuilder’ı kullanmadan ADVANCE alanını bir Belgeye ekleme
ADVANCE alanı bir satır içindeki sonraki metni sola, sağa, yukarı veya aşağı kaydırmak için kullanılır. Word belgesindeki ADVANCE alanı FieldAdvance sınıfıyla temsil edilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAdvance sınıfını kullanabilirsiniz:
- alanı takip eden metnin sayfanın üst kenarından dikey olarak taşınması gereken nokta sayısını belirtin
- alanı takip eden metnin sütunun, çerçevenin veya metin kutusunun sol kenarından yatay olarak taşınması gereken nokta sayısını belirtin
- alanı takip eden metnin sola, sağa, yukarı veya aşağı taşınması gereken nokta sayısını belirtin
Aşağıdaki kod örneği, DOM kullanarak ADVANCE Alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir:
DocumentBuilder’ı kullanmadan ASK alanını bir Belgeye ekleme
ASK alanı, kullanıcıdan Word belgesindeki bir Yer İşaretine atanacak metni istemek için kullanılır. Word belgesindeki ASK alanı FieldAsk sınıfıyla temsil edilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAsk sınıfını kullanabilirsiniz:
- yer iminin adını belirtin
- varsayılan kullanıcı yanıtını belirtin (istem penceresinde bulunan başlangıç değeri)
- Mail Merge işlemi başına kullanıcı yanıtının bir kez alınması gerekip gerekmediğini belirtin
- bilgi istemi metnini belirtin (bilgi istemi penceresinin başlığı)
Aşağıdaki kod örneği, DOM kullanarak ASK Alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir:
DocumentBuilder’ı kullanmadan AUTHOR alanını bir Belgeye ekleme
AUTHOR alanı, Document özelliklerinden Belgenin yazarının adını belirtmek için kullanılır. Word belgesindeki AUTHOR alanı FieldAuthor sınıfıyla temsil edilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAuthor sınıfını kullanabilirsiniz:
- belge yazarının adını belirtin
Aşağıdaki kod örneği, DOM kullanarak AUTHOR Alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir:
DocumentBuilder’ı kullanmadan INCLUDETEXT alanını bir Belgeye ekleme
INCLUDETEXT alanı, alan kodunda adı geçen belgenin içerdiği metin ve grafikleri ekler. Belgenin tamamını veya yer imi tarafından belirtilen belgenin bir kısmını ekleyebilirsiniz. Word belgesindeki bu alan INCLUDETEXT ile temsil edilir. Aşağıdaki işlemleri gerçekleştirmek için FieldIncludeText sınıfını kullanabilirsiniz:
- dahil edilen belgenin yer iminin adını belirtin
- belgenin konumunu belirtin
Aşağıdaki kod örneği, DOM kullanarak INCLUDETEXT alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir:
DocumentBuilder’ı kullanmadan TOA alanını bir Belgeye ekleme
TOA (Yetki Tablosu) alanı bir yetki tablosu oluşturur ve ekler. TOA alanı, TA (Yetki Tablosu Girişi) alanlarıyla işaretlenen girişleri toplar. Microsoft Office Word, References sekmesindeki Yetki Tablosu grubunda Yetki Tablosu Ekle seçeneğini tıklattığınızda TOA alanını ekler. Belgenizde TOA alanını görüntülediğinizde söz dizimi şu şekilde görünür:
{ TOA [Switches ] }
Aşağıdaki kod örneği, DOM kullanarak TOA alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir: