Yer işareti denetimi

Denetim Bookmark , benzersiz bir ada sahip olan, olayları kullanıma sunan ve verilere bağlanabilen bir yer işaretidir. Yer işareti, Microsoft Office Word belgesindeki bir öğeyi veya konumu işaretlemek için yer tutucu olarak kullanılabilir. Denetim Bookmark , bir Bookmark nesne ile nesnenin birleşimidir Range .

Şunlar için geçerlidir: Bu konudaki bilgiler, Word için belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Belge düzeyi projelerde, belgenize tasarım zamanında veya çalışma zamanında denetimler ekleyebilirsiniz Bookmark . VSTO Eklenti projelerinde, çalışma zamanında açık olan herhangi bir belgeye denetim ekleyebilirsiniz Bookmark . Daha fazla bilgi için bkz . Nasıl yapılır: Word belgelerine Yer İşareti denetimleri ekleme.

Verileri denetime bağlama

Denetim Bookmark , basit veri bağlamayı destekler. Yer işareti özelliği kullanılarak DataBindings bir veri kaynağına bağlanmalıdır. Yer işaretinin varsayılan veri bağlama özelliği özelliğidir Text .

İlişkili veri kümesindeki veriler güncelleştirilirse, Bookmark denetim değişiklikleri gösterir.

Belge düzeyindeki projelerde, Veri Kaynakları penceresini kullanarak verileri yer işaretlerine de bağlayabilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: Belgeleri nesnelerden alınan verilerle doldurma.

Biçimlendirme

öğesine uygulanabilen biçimlendirme bir Bookmark denetime Bookmark uygulanabilir. Bu biçimlendirme yazı tiplerini, girintileri, aralığı, numaralandırmayı ve stilleri içerir.

Yer işaretine metin atama

Nesne ile denetim arasındaki Microsoft.Office.Interop.Word.Bookmark ek fark Microsoft.Office.Tools.Word.Bookmark , yer işaretine metin atandığında nasıl davrandığıdır. Metni sıfır uzunluklu Microsoft.Office.Interop.Word.Bookmarkbir değere atarsanız, metin yer işaretinin sağındaki eklenir ve yer işareti sıfır uzunlukta kalır. Ancak, metni sıfır uzunluklu Microsoft.Office.Tools.Word.Bookmarkbir değere atarsanız, metin yer işaretine eklenir ve yer işaretinin uzunluğu eklenen toplam karakter sayısına kadar genişler.

Denetimin Microsoft.Office.Tools.Word.Bookmark özelliği de vardır Bookmark.Text . Bu özellik, denetimin Range.Text özelliğinde Bookmark.Range veya bir Microsoft.Office.Tools.Word.Bookmark nesnenin özelliğinde Bookmark.Range bulunan özelliğinden Microsoft.Office.Interop.Word.Bookmark farklıdır.

Metin Özelliği Açıklama
Bookmark.Text Yer işareti içinde metin görüntülemek ve yer işaretini belgede bırakmak için bu özelliği kullanın. Yer işaretine metin atamak yer işareti aralığını genişletir ve yer işaretini silmez.

Örneğin, Bookmark1.Text = "Hello world" metni yer işaretine ekler ve yer işaretini olduğu gibi bırakır.
Range.Text Metni yer işareti konumunda görüntülemek ve yer işaretini otomatik olarak silmek için bu özelliği kullanın. Örneğin, Bookmark1.Range.Text = "Hello world" metni yer işaretine ekler ve yer işaretini siler.

Tasarım zamanında denetimi yeniden adlandırma

Belge düzeyi projelerde, araç kutusundan belgenize bir Bookmark denetim sürüklediğinizde, Visual Studio denetim için otomatik olarak bir ad oluşturur. Denetimin adını Özellikler penceresinde değiştirebilirsiniz.

Çakışan denetimler

Yer işareti denetimleri birbiriyle örtüşebilir. Aynı metin birden fazla yer işareti tarafından paylaşılabilir. Çakışan yer işaretlerinden birine yeni metin atadığınızda, yalnızca yeni metni içerir ve yer işaretleri artık çakışmaz. Diğer yer işareti artık yalnızca özgün çakışan yer işaretleri arasında paylaşılmamış olan metni içeriyor.

Aşağıdaki tabloda, "Bu örnek metindir" cümlesinin çakışan iki yer işareti tarafından nasıl paylaşılmış olduğu gösterilmektedir:

Yer işareti Metin
Çakışan yer işaretleri [bu {sample] metnidir.}
Yer İşareti1 Bu örnektir
Yer İşareti2 örnek metin.

Yeni "Bu değiştiriliyor" metnini Yer İşareti1'e atarsanız, yer işaretleri çakışmaz ve Yer İşareti2 yalnızca Başlangıçta Yer İşareti1'in parçası olmayan metni korur.

Yer işareti Metin
İki ayrı yer işareti [bu değiştiriliyor] { text.}
Yer İşareti1 Bu, değiştirme işlemidir
Yer İşareti2 Metin.

Başka bir yer işareti içeren yer işaretinin metnini değiştirirseniz, iç yer işareti silinmez. Ancak, iç yer işareti boş bir yer işaretine dönüşür ve dış yer işaretinin sonuna taşınır.

Aşağıdaki tabloda, "Bu örnek metindir" cümlesinin başka bir yer işaretinin içinde yer alan bir yer işareti tarafından nasıl paylaşıldığını gösterilmektedir:

Yer işareti Metin
Çakışan yer işaretleri [bu {sample} metnidir.]
Yer İşareti1 Bu örnek metindir.
Yer İşareti2 örnek

Yeni "Bu değiştiriliyor" metnini Yer İşareti1'e atarsanız, yer işaretleri artık çakışamaz ve Yer İşareti2, Yer İşareti1'in sonunda bulunan boş bir yer işaretine dönüşür.

Yer işareti Metin
İki ayrı yer işareti [bu yenidir.]{}
Yer İşareti1 Bu, yerine geçer.
Yer İşareti2 <empty>

Olaylar

Denetim için Bookmark aşağıdaki olaylar kullanılabilir: