Insert Fields

Bir belgeye alanlar eklemek için farklı birkaç yol vardır:''

• DocumentBuilder kullanıyor – FieldBuilder kullanıyor
• kullanmak Aspose.Words Document Object Model (DOM)

Bu makale içinde her bir yolu daha detaylı inceleyip bu seçenekleri kullanarak belirli alanları nasıl ekleyeceğimizi analiz edeceğiz.

Bir Belgeye Alanlar Ekleme kullanarak Belge Oluşturucu

Aspose.Words ‘de yeni alanları bir belgenin içine eklemek için InsertField yöntemi kullanılır. İlk parametre eklenecek alanın tam alan kodunu alır. İkinci parametre isteğe bağlıdır ve alanı el ile belirtebilme imkanı verir. Bu parametre sağlanmazsa alan otomatik olarak güncellenir. Bu parametreye null veya boş geçerseniz boş değerli bir alan eklenir. Belirli bir alan kodunun sözdizimi hakkında emin değilseniz önce Microsoft Word ‘de alanı oluşturup geçiş yaparak alan kodunu görebilirsiniz.

Eğer alan kodunuz bir boşluk içeren bir parametre içeriyorsa, bu parantez içinde olmalıdır. Yoksa hem Microsoft Word ve Aspose.Words içindeki alan beklendiği gibi çalışmayabilir çünkü parametre her ikisi tarafından da kesildiği düşünülür.

Örnek kodun aşağıdaki kısmı, bir belgeye DocumentBuilder kullanarak bir birleştirme alanı eklemeyi gösterir:

Diğer alanları içeren alanların içine girilmesi için aynı teknik kullanılır.

Aşağıdaki kod örneği, başka bir alanın içinden iç içe geçmiş alanlar eklemek için DocumentBuilder kullanmanın nasıl yapılacağını göstermektedir:

Bölgeyi Alan Düzeyinde Belirtin

Bir dil tanımlayıcısı bir ülke veya coğrafi bölgede kullanılan bir dilin standart uluslararası sayısal kısaltmasıdır. Aspose.Words ile, bir alan seviyesinde bölgeyi belirtmek için LocaleId özelliğini kullanarak bölgeyi belirtebilirsiniz, bu özellik alanı alır ya da ayarlar.

Aşağıdaki kod örneği bu seçeneği nasıl kullanacağınızı gösterir:

Untइप Edilmiş/Boş Alan Ekle

Eğer boş alanlar girmeniz/boş bırakmanız gerekirse {}, tıpkı Microsoft Word’ün izin verdiği gibi, InsertField metodunu ve FieldType.FieldNone parametresini kullanabilirsiniz. Bir Word belgesine alan eklemek için, “Ctrl+F9” tuş kombinasyonuna basabilirsiniz.

Aşağıdaki kod örneğinde belgeye boş bir alan eklemenin nasıl yapılacağını gösterir:

Sıra COMPARE Alanını Girin

1 COMPARE alanı, iki değeri karşılaştırır ve karşılaştırma true ise sayısal değer 1’i, false ise 0’ı döndürür.

Aşağıdaki kod örneği, DocumentBuilder kullanarak COMPARE alanını nasıl ekleyeceğini göstermektedir:

Girdi IF Alanı

The IF alanı koşullu olarak bağımsız değişkenleri değerlendirmek için kullanılabilir.

Aşağıdaki kod örneği, DocumentBuilder kullanarak IF alanı nasıl ekleneceğini göstermektedir

フィールドビルダーを使用したドキュメントへのフィールドの挿入

Aspose.Words’deki alanları eklemenin alternatif yolu FieldBuilder sınıfıdır. Alan anahtarlarını ve bağımsız değişken değerlerini metin, düğümler veya hatta iç içe geçmiş alanlar olarak belirtmek için pürüzsüz bir arayüz sağlar.

Aşağıdaki kod örneği bir belgeye alan eklemek için FieldBuilder kullanmayı gösterir:

Alanları DOM kullanarak ekleme yapın

Ayrıca çeşitli türde alanları Aspose.Words Document Object Model (DOM) kullanarak ekleyebilirsiniz. Bu bölümde, birkaç örneğe göz atacağız.

Bir Belgeye DOM kullanarak Birleştirme Alanı Ekleme

Word belgesindeki MERGEFIELD alanı FieldMergeField sınıfı ile temsil edilebilir. Aşağıdaki işlemleri yapmak için FieldMergeField sınıfını kullanabilirsiniz:

• birleştirme alanının adını belirtin
• birleştirme alanının biçimini belirtin
• birleştirme alanındaki alan ayırıcı ile alan sonu arasındaki metni belirtin
• birleştirme alanı boş değilse, birleştirme sonrası eklenmesini istenen metni belirtin
• birleştirme alanının boş olmadığı durumlarda ekleyilecek metni belirtin

Daha fazla ayrıntı için FieldMergeField sınıfına bakın API.

Aşağıdaki kod örneği bir belgedeki paragrafta bir MERGE alanı eklemek için DOM’in nasıl kullanılacağını göstermektedir:

Bir Dokümanda DOM kullanarak Mail Merge ADDRESSBLOCK alanını ekler

The ADDRESSBLOCK alanı bir Word belgesine bir 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:

• bu alanda ülkenin/bölgenin adını dahil edip etmemeye karar verin
• alıcının bulunduğu ülke/bölgeye göre adresin biçimlendirilip edilmeyeceğini belirtir, Postcode (Evrensel Posta Birliği 2006) tarafından tanımlanır
• hariç tutulan ülke/bölge adını belirtin
• ad ve adres formatını belirtin Adresi biçimlendirmek için kullanılan dil kimliğini belirtir

Daha fazla ayrıntı için FieldAddressBlock sınıfına bakın API.

Aşağıdaki kod örneğinde, bir belgedeki bir paragrafta bir Mail Merge ADDRESSBLOCK Alanı eklemek için DOM kullanmayı gösterir:

DocumentBuilder kullanmadan bir belgeye ADVANCE alanı eklemek

The ADVANCE alanı bir satır içindeki sonraki metni sola, sağa, yukarıya veya aşağıya yatay olarak doğru kaydırmak için kullanılır. Bir Word belgesindeki ADVANCE alanı FieldAdvance sınıfıyla temsil edilebilir. Aşağıdaki işlemleri yapmak için FieldAdvance sınıfını kullanabilirsiniz:

• belirtin, metin alanının altında bulunan metnin sayfa üst kenarının dikey olarak ne kadar hareket ettirileceğini belirten nokta sayısı
• belirtin alanın ardından gelen metnin sütun, çerçeve veya metin kutusu sol kenarından yatay olarak taşınması gereken nokta sayısı
• aşağıdaki alanı izleyen metni sola, sağa, yukarı veya aşağı taşımak için gereken noktaların sayısını belirtin

Daha fazla ayrıntı için FieldAdvance sınıfını API’e bakın.

Aşağıdaki kod örneği, bir belgeye DOM kullanarak bir paragrafta ADVANCE alanı eklemeyi gösterir:

Bir Belgeye ASK alanı ekleme, BelgeBuilder kullanmadan

The ASK alanı, bir Word belgesindeki bir Yer İşareti için kullanıcıdan metin girmesini istemek için kullanılır. Word belgesindeki ASK alanı, FieldAsk sınıfı ile temsil edilebilir. Aşağıdaki işlemleri yapmak için FieldAsk sınıfını kullanabilirsiniz:

• imzanın adını belirtir
• varsayılan kullanıcı yanıtını belirtin (isteme penceresinde bulunan başlangıç değeri)
• kullanıcının yanıtını bir Mail Merge işlemi başına bir kez almayı belirtin
• istemi metnini (istemi penceresinin başlığı) belirtin

Daha fazla ayrıntı için FieldAsk sınıfına bakın API.

Aşağıdaki kod örneği bir belgedeki bir paragrafına ASK alanı eklemek için DOM kullanmayı gösterir:

Bir Belge içine bir AUTHOR alanı ekleme, Belge oluşturucu kullanmadan

The AUTHOR alanı, Document özelliklerinden yazarın adını belirtmek için kullanılır. Word belgesindeki AUTHOR alanını FieldAuthor sınıfı temsil edebilir. Aşağıdaki işlemleri yapmak için FieldAuthor sınıfını kullanabilirsiniz:

• belge yazarının adını belirtir

Daha detaylı bilgi için FieldAuthor sınıfını API görün.

Aşağıdaki kod örneği bir belgedeki bir paragrafta AUTHOR alanını nasıl ekleyeceğinizi gösterir: DOM

Bir belgeye DocumentBuilder kullanmadan INCLUDETEXT alanı ekleme

The INCLUDETEXT alanı, alan kodunda belirtilen belge içindeki metni ve grafikleri ekler. Tüm belgeyi veya bir işaretçiye atıfta bulunan bir belgenin parçasını ekleyebilirsiniz. Word belgesindeki bu alan IncluSetext ile temsil edilir. Aşağıdaki işlemleri yapmak için FieldIncludeText sınıfını kullanabilirsiniz:

• dahil edilen belge için yer imi adı belirtin
• belgenin konumunu belirtin

Daha fazla ayrıntı için, FieldIncludeText sınıfını API’e bakın.

Aşağıdaki kod örneği bir belgeye bir paragrafta INCLUDETEXT alanını eklemek için DOM kullanımını gösterir:

Bir belgeye DocumentBuilder kullanmadan TOA alanını ekleme

The TOA (Table of Authorities) alanı bir tablo oluşturur ve ekler. The TOA alanı TA (Table of Authority Entry) alanlarıyla işaretlenmiş girdileri toplar. Microsoft Office Word, References sekmesindeki Yetkililerin Tablosu grubundaki Insert Table of Authorities düğmesine tıkladığınızda TOA alanını ekler. Dokümanınızda TOA alanına baktığınızda sözdizimi şu gibi görünecektir:

{ TOA [Switches ] }

Daha fazla ayrıntı için FieldToa sınıfı API’e bakın.

Aşağıdaki kod örneği, bir belgedeki bir paragrafta TOA alanı eklemek için DOM’i nasıl kullanıldığını göstermektedir.