Belge Öğeleri Eklemek için `DocumentBuilder` kullanın

DocumentBuilder, belgeleri değiştirmek için kullanılır. Bu makalede, bir dizi görevin nasıl gerçekleştirileceği açıklanır ve açıklanır:

Bir Metin Dizesi Ekleme

Belgeye eklemeniz gereken metin dizesini DocumentBuilder.Write yöntemine iletmeniz yeterlidir. Metin biçimlendirmesi Font özelliği tarafından belirlenir. Bu nesne farklı yazı tipi öznitelikleri (yazı tipi adı, yazı tipi boyutu, renk vb.) İçerir. Bazı önemli yazı tipi öznitelikleri, bunlara doğrudan erişmenize izin vermek için DocumentBuilder özellikleriyle de temsil edilir. Bunlar Font.Bold, Font.Italic ve Font.Underline Boolean özellikleridir.

Ayarladığınız karakter biçimlendirmesinin belgedeki geçerli konumdan itibaren eklenen tüm metinlere uygulanacağını unutmayın.

Aşağıdaki örnek, DocumentBuilder kullanılarak biçimlendirilmiş metin ekler.

Paragraf Ekleme

DocumentBuilder.Writeln belgeye bir metin dizesi de ekler, ancak ek olarak bir paragraf sonu ekler. Geçerli yazı tipi biçimlendirmesi DocumentBuilder.Font özelliği tarafından da belirtilir ve geçerli paragraf biçimlendirmesi DocumentBuilder.ParagraphFormat özelliği tarafından belirlenir. Aşağıdaki örnek, belgeye nasıl paragraf ekleneceğini gösterir.

Tablo Ekleme

DocumentBuilder kullanarak bir tablo oluşturmak için temel algoritma basittir:

1. Tabloyu DocumentBuilder.StartTable kullanarak başlatın.
2. DocumentBuilder.InsertCell kullanarak bir hücre ekleyin. Bu otomatik olarak yeni bir satır başlatır. Gerekirse, hücre biçimlendirmesini belirtmek için DocumentBuilder.CellFormat özelliğini kullanın.
3. DocumentBuilder yöntemlerini kullanarak hücre içeriğini ekleyin.
4. Satır tamamlanana kadar 2 ve 3 adımlarını tekrarlayın.
5. Geçerli satırı sonlandırmak için DocumentBuilder.EndRow öğesini çağırın. Gerekirse, satır biçimlendirmesini belirtmek için DocumentBuilder.RowFormat özelliğini kullanın.
6. Tablo tamamlanana kadar 2 - 5 adımlarını tekrarlayın.
7. Tablo oluşturmayı bitirmek için DocumentBuilder.EndTable öğesini arayın. Uygun DocumentBuilder tablo oluşturma yöntemleri aşağıda açıklanmıştır.

Bir Tablo Başlatma

DocumentBuilder.StartTable ‘ı çağırmak, bir tablo oluşturmanın ilk adımıdır. Bir hücrenin içinde de çağrılabilir, bu durumda iç içe geçmiş bir tablo başlatır. Aranacak bir sonraki yöntem DocumentBuilder.InsertCell ‘dir.

Hücre Ekleme

DocumentBuilder->InsertCell öğesini çağırdıktan sonra yeni bir hücre oluşturulur ve DocumentBuilder sınıfının diğer yöntemlerini kullanarak eklediğiniz tüm içerikler geçerli hücreye eklenir. Aynı satırda yeni bir hücre başlatmak için DocumentBuilder->InsertCell öğesini tekrar arayın. Hücre biçimlendirmesini belirtmek için DocumentBuilder.CellFormat özelliğini kullanın. Bir tablo hücresinin tüm biçimlendirmesini temsil eden bir CellFormat nesnesi döndürür.

Bir Satırın Sonu

Geçerli satırı bitirmek için DocumentBuilder.EndRow öğesini çağırın. Bundan hemen sonra DocumentBuilder->InsertCell ararsanız, tablo yeni bir satırda devam eder.

Satır biçimlendirmesini belirtmek için DocumentBuilder.RowFormat özelliğini kullanın. Bir tablo satırı için tüm biçimlendirmeyi temsil eden bir RowFormat nesnesi döndürür.

Bir Tabloyu Sonlandırma

Geçerli tabloyu bitirmek için DocumentBuilder.EndTable öğesini çağırın. Bu yöntem DocumentBuilder->EndRow çağrıldıktan sonra yalnızca bir kez çağrılmalıdır. Çağrıldığında, DocumentBuilder.EndTable imleci geçerli hücreden tablodan hemen sonraki bir konuma taşır. Aşağıdaki örnek, 2 satır ve 2 sütun içeren biçimlendirilmiş bir tablonun nasıl oluşturulacağını gösterir.

Bir Mola Ekleme

Açıkça yeni bir satır, paragraf, sütun, bölüm veya sayfa başlatmak istiyorsanız DocumentBuilder.InsertBreak öğesini arayın. BreakType numaralandırmasıyla temsil edilen, eklemeniz gereken kesme türünü bu yönteme iletin. Aşağıdaki örnek, bir belgeye sayfa sonlarının nasıl ekleneceğini gösterir.

Resim Ekleme

DocumentBuilder satır içi veya kayan bir görüntü eklemenize izin veren DocumentBuilder->InsertImage yönteminin birkaç aşırı yüklenmesini sağlar. Resim bir EMF veya WMF meta dosyası ise, belgeye meta dosyası biçiminde eklenir. Diğer tüm görüntüler PNG biçiminde saklanacaktır. DocumentBuilder->InsertImage yöntemi farklı kaynaklardan görüntüler kullanabilir:

• Bir dosyadan veya URL bir dize parametresi geçirerek DocumentBuilder->InsertImage.
• Bir Stream parametresi DocumentBuilder->InsertImage geçirerek bir akıştan.
• Bir Görüntü nesnesinden bir Görüntü parametresi geçirerek DocumentBuilder->InsertImage.
• Bir bayt dizisinden bir bayt dizisi parametresi geçirerek DocumentBuilder.InsertImage.DocumentBuilder->InsertImage yöntemlerinin her biri için, aşağıdaki seçeneklerle bir görüntü eklemenize izin veren başka aşırı yüklenmeler de vardır:
• Satır içi veya belirli bir konumda yüzer, örneğin DocumentBuilder->InsertImage.
• Yüzde ölçeği veya özel boyut, örneğin DocumentBuilder.InsertImage. Ayrıca DocumentBuilder->InsertImage yöntemi, Şeklin özelliklerini daha fazla değiştirebilmeniz için yeni oluşturulmuş ve eklenmiş bir Shape nesnesi döndürür.

Satır İçi Görüntü Ekleme

Görüntüyü belgeye satır içi grafik olarak eklemek için görüntüyü içeren bir dosyayı temsil eden tek bir dizeyi DocumentBuilder->InsertImage konumuna geçirin. Aşağıdaki örnek, imleç konumundaki satır içi görüntünün belgeye nasıl ekleneceğini gösterir.

Kayan (Kesinlikle Konumlandırılmış) Bir Görüntü Ekleme

Bu örnek, bir dosyadan veya URL ‘dan belirli bir konuma ve boyuta kayan bir görüntü ekler.

Yer imi Ekleme

Belgeye bir yer imi eklemek için aşağıdakileri yapmanız gerekir:

1. DocumentBuilder->StartBookmark öğesini çağırın ve yer iminin istediğiniz adını iletin.
2. DocumentBuilder yöntemlerini kullanarak yer imi metnini ekleyin.
3. DocumentBuilder.EndBookmark ile DocumentBuilder->StartBookmark ile kullandığınız adın aynısını ileterek arayın.
4. Yer imleri üst üste gelebilir ve herhangi bir aralığı kapsayabilir. Geçerli bir yer imi oluşturmak için DocumentBuilder->StartBookmark ve DocumentBuilder->EndBookmark ‘yi aynı yer imi adıyla çağırmanız gerekir.

Belge kaydedildiğinde kötü biçimlendirilmiş yer imleri veya yinelenen adlara sahip yer imleri göz ardı edilir.

Aşağıdaki örnek, bir belge oluşturucuyu kullanarak bir belgeye yer iminin nasıl ekleneceğini gösterir.

Form Alanı Ekleme

Form alanları, kullanıcıyla “etkileşime” izin veren belirli bir Sözcük alanı durumudur. Microsoft Word içindeki form alanları metin kutusu, birleşik giriş kutusu ve onay kutusunu içerir.DocumentBuilder her tür form alanını belgeye eklemek için özel yöntemler sağlar: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox ve DocumentBuilder.InsertComboBox. Form alanı için bir ad belirtirseniz, aynı ada sahip bir yer iminin otomatik olarak oluşturulduğunu unutmayın.

Metin Girişi Ekleme

DocumentBuilder.InsertTextInput belgeye bir metin kutusu eklemek için. Aşağıdaki örnek, bir belgeye metin giriş formu alanının nasıl ekleneceğini gösterir.

Onay Kutusu Ekleme

Belgeye bir onay kutusu eklemek için DocumentBuilder.InsertCheckBox öğesini arayın. Aşağıdaki örnek, bir belgeye onay kutusu form alanının nasıl ekleneceğini gösterir.

Birleşik Giriş Kutusu Ekleme

Belgeye birleşik giriş kutusu eklemek için DocumentBuilder.InsertComboBox öğesini arayın. Aşağıdaki örnek, bir belgeye birleşik giriş kutusu form alanının nasıl ekleneceğini gösterir.

Alan Düzeyinde Yerel Ayar Ekleme

Müşteriler artık alan düzeyinde Yerel Ayarı belirtebilir ve daha iyi kontrol sağlayabilir. Yerel Ayar Kimlikleri DocumentBuilder içindeki her alanla ilişkilendirilebilir. Aşağıdaki örnekler, bu seçeneğin nasıl kullanılacağını göstermektedir.

Köprü Ekleme

Belgeye köprü eklemek için DocumentBuilder.InsertHyperlink kullanın. Bu yöntem üç parametreyi kabul eder: belgede görüntülenecek bağlantının metni, bağlantı hedefi (URL veya belgenin içindeki bir yer iminin adı) ve URL belgenin içindeki bir yer iminin adıysa doğru olması gereken bir boole parametresi.DocumentBuilder.InsertHyperlink dahili olarak DocumentBuilder.InsertField çağırır.Yöntem her zaman URL ‘nın başına ve sonuna kesme işaretleri ekler. Köprü görüntüleme metni için yazı tipi biçimlendirmesini Font özelliğini kullanarak açıkça belirtmeniz gerektiğini unutmayın. Aşağıdaki örnek, DocumentBuilder kullanarak bir belgeye bir köprü ekler.

Ole Nesnesi Ekleme

Ole Nesnesi istiyorsanız DocumentBuilder.InsertOleObject öğesini çağırın. Bu yönteme ProgId diğer parametrelerle açıkça iletin. Aşağıdaki örnek, bir belgeye Ole Nesnesinin nasıl ekleneceğini gösterir.

Ole Nesnesi Eklerken Dosya Adını ve Uzantısını Ayarlama

OLE paket, OLE işleyicisi bilinmiyorsa gömülü nesneyi depolamanın eski ve “belgelenmemiş” bir yoludur. Windows 3.1, 95 ve 98 gibi ilk Windows sürümlerinde Paketleyici vardı.herhangi bir veri türünü belgeye gömmek için kullanılabilecek exe uygulaması. Şimdi, bu uygulama Windows dışında bırakıldı, ancak MS Word ve diğer uygulamalar, OLE işleyicisi eksik veya bilinmiyorsa verileri gömmek için kullanmaya devam ediyor. OlePackage sınıfı, OLE Paket özelliklerine erişime izin verir. Aşağıdaki örnek, OLE Paketi için dosya adı, uzantı ve görünen adın nasıl ayarlanacağını gösterir.

Ekleme HTML

Word belgesine HTML parçası veya tamamı HTML belgesi içeren bir HTML dizesini kolayca ekleyebilirsiniz. Bu dizeyi DocumentBuilder->InsertHtml yöntemine iletmeniz yeterlidir. Yöntemin yararlı uygulamalarından biri, bir HTML dizesini bir veritabanında depolamak ve mail merge sırasında belgeye eklemek, belge oluşturucunun çeşitli yöntemlerini kullanarak oluşturmak yerine biçimlendirilmiş içeriği eklemektir. Aşağıdaki örnekte, DocumentBuilder kullanarak bir belgeye HTML ekler gösterilmektedir.

Belgeye Yatay Kural Ekleme

Below code örneği, DocumentBuilder->InsertHorizontalRule yöntemini kullanarak bir belgeye yatay kural şeklinin nasıl ekleneceğini gösterir.