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.

Alan kodunuzda boşluk içeren bir parametre varsa, bunun konuşma işaretlerinin içine alınması gerekir. Aksi halde, hem Microsoft Word hem de Aspose.Words’deki alan, parametre her ikisi tarafından da kesilmiş olarak değerlendirileceğinden beklendiği gibi çalışmayabilir.

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

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

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

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

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

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

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ığı)

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

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

Daha fazla ayrıntı için FieldAuthor sınıfı API’ye bakın.

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

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

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 ] }

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

Aşağıdaki kod örneği, DOM kullanarak TOA alanının bir belgedeki paragrafa nasıl ekleneceğini gösterir: