İçerik Kontrolü SDT ile Çalışma

Microsoft Word’te bir şablonla başlayıp onay kutuları, metin kutuları, tarih seçiciler ve açılır listeler dahil içerik kontrolleri ekleyerek bir form oluşturabilirsiniz. Aspose.Words’de, Aspose.Words’ye yüklenen herhangi bir belgedeki Yapılandırılmış Belge Etiketi veya içerik kontrolü, StructuredDocumentTag düğümü olarak içe aktarılır. Yapılandırılmış belge etiketleri (SDT veya içerik kontrolü), müşteri tanımlı anlambilimin yanı sıra davranışının ve görünümünün bir belgeye yerleştirilmesine olanak tanır.

StructuredDocumentTag bir belgede aşağıdaki yerlerde bulunabilir:

  • Blok düzeyinde – Paragraflar ve tablolar arasında, bir Gövde, ÜstbilgiFooter, Yorum, Dipnot veya Şekil düğümünün alt öğesi olarak
  • Satır düzeyi – Bir Tablo düğümünün alt öğesi olarak, bir tablodaki satırlar arasında
  • Hücre düzeyi – Bir Satır düğümünün alt öğesi olarak, bir tablo satırındaki hücreler arasında
  • Satır içi düzey – Bir Paragrafın alt öğesi olarak içerideki satır içi içerik arasında
  • Başka bir StructuredDocumentTag’in içine yerleştirilmiştir

İçerik Kontrollerini Belgeye Ekleme

Aspose.Words’in bu sürümünde aşağıdaki SDT türleri veya içerik kontrolü oluşturulabilir:

  • Checkbox
  • DropDownList
  • ComboBox
  • Date
  • BuildingBlockGallery
  • Group
  • Picture
  • RichText
  • PlainText

Aşağıdaki kod örneği, tür onay kutusunun içerik denetiminin nasıl oluşturulacağını gösterir:

Aşağıdaki kod örneği, tür zengin metin kutusunun içerik denetiminin nasıl oluşturulacağını gösterir:

Aşağıdaki kod örneği, tür birleşik giriş kutusunun içerik denetiminin nasıl oluşturulacağını gösterir:

İçerik Kontrolleri Nasıl Güncellenir?

Bu bölümde SDT veya içerik denetimi değerlerinin programlı olarak nasıl güncelleneceği açıklanmaktadır.

Aşağıdaki kod örneği, onay kutusunun geçerli durumunun nasıl ayarlanacağını gösterir:

Aşağıdaki kod örneği, düz metin kutusu, açılır liste ve resim türündeki içerik denetimlerinin nasıl değiştirileceğini gösterir:

İçerik Denetimini Özel XML Parçalarına Bağlama

İçerik kontrollerini Word belgelerindeki XML verileriyle (özel XML bölümü) bağlayabilirsiniz.

Aşağıdaki kod örneği, içerik denetiminin özel XML bölümlerine nasıl bağlanacağını gösterir:

Yapılandırılmış Belge Etiket Aralığının XML Eşlemesi

Bu yapılandırılmış belge etiketi aralığının, StructuredDocumentTagRangeStart.XmlMapping özelliği‘i kullanarak geçerli belgenin özel bir XML bölümündeki XML verileriyle eşlenmesini sağlayabilirsiniz. Ancak, yapılandırılmış bir belge etiketi aralığını XML verileriyle eşlemek için SetMapping yöntemi kullanılabilir.

Aşağıdaki kod örneği, XML eşlemesinin nasıl ayarlanacağını gösterir:

İçerik Denetiminin İçeriğini Temizleme

Bir yer tutucu görüntüleyerek içerik denetiminin içeriğini temizleyebilirsiniz. StructuredDocumentTag.Clear yöntemi, bu yapılandırılmış belge etiketinin içeriğini temizler ve tanımlanmışsa bir yer tutucu görüntüler. Ancak bir içerik denetiminin içeriğinde düzeltmeler varsa, bunların temizlenmesi mümkün değildir. İçerik kontrolünün yer tutucusu yoksa Microsoft Word’deki gibi beş boşluk eklenir (yinelenen bölümler, yinelenen bölüm öğeleri, gruplar, onay kutuları, alıntılar hariç). Bir içerik denetimi özel XML ile eşlenirse başvurulan XML düğümü temizlenir.

Aşağıdaki kod örneği, içerik denetimi içeriğinin nasıl temizleneceğini gösterir:

İçerik Kontrolü Arka Planını ve Kenarlık Renklerini Değiştirme

StructuredDocumentTag.Color özelliği, içerik kontrolünün rengini almanıza veya ayarlamanıza olanak tanır. Renk, içerik kontrolünü iki durumda etkiler:

  1. MS Word, fare içerik kontrolünün üzerine geldiğinde içerik kontrolünün arka planını vurgular. Bu, içerik kontrolünün tanımlanmasına yardımcı olur. Vurgulamanın rengi Color‘ten biraz “daha yumuşaktır”. Örneğin, MS Word, Color Kırmızı olduğunda arka planı pembe renkle vurgular.
  2. İçerik kontrolüyle etkileşimde bulunduğunuzda (düzenleme, seçme vb.), içerik kontrolünün çerçevesi Color ile renklendirilir.

Aşağıdaki kod örneği, içerik denetiminin renginin nasıl değiştirileceğini gösterir:

İçerik Denetimine Yazılan Metni Biçimlendirmek için Stil Nasıl Ayarlanır

İçerik kontrolünün stilini ayarlamak istiyorsanız StructuredDocumentTag.Style veya StructuredDocumentTag.StyleName özelliklerini kullanabilirsiniz. Çıktı belgesindeki içerik kontrolüne metni yazdığınızda, yazılan metin “Alıntı” stiline sahip olacaktır.

Aşağıdaki kod örneği, içerik denetimi stilinin nasıl ayarlanacağını gösterir:

Tekrarlanan Bölüm İçeriği Denetimiyle Çalışma

Tekrarlanan bölüm içerik kontrolü, içinde yer alan içeriğin tekrarlanmasına olanak tanır. Aspose.Words kullanılarak yinelenen bölüm ve yinelenen bölüm öğe türlerinin yapılandırılmış belge etiketi düğümleri oluşturulabilir ve SdtType numaralandırma türü bu amaçla RepeatingSectionItem özelliği sağlar.

Aşağıdaki kod örneği, yinelenen bölüm içerik denetiminin bir tabloya nasıl bağlanacağını gösterir.

C#'te Form Alanlarıyla Çalışmak Kontrol Karakterleriyle Çalışmak