Yer İşareti Denetimi

Makale
08/01/2011

Microsoft.Office.Tools.Word.Bookmark denetimi, eşsiz ismi olan, olaylar yaratan ve verilere bağlanabilen bir yer işaretidir. Yer işareti, Microsoft Office Word belgesinde bir öğeyi veya konumu işaretlemek için kullanılan bir yer tutucudur. Microsoft.Office.Tools.Word.Bookmark denetimi, Microsoft.Office.Interop.Word.Bookmark ve Microsoft.Office.Interop.Word.Range nesnesinin birleşimidir.

Uygulama alanı: Bu konudaki bilgiler Word 2007 ve Word 2010 uygulamalarının belge düzeyi projelerine ve uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Belge düzeyi projelerinde Microsoft.Office.Tools.Word.Bookmark denetimlerini belgenize tasarım veya çalışma anında ekleyebilirsiniz. Belge düzeyi projeleri uygulamarında Microsoft.Office.Tools.Word.Bookmark denetimlerini herhangi bir açık belgeye çalışma anında ekleyebilirsiniz. Daha fazla bilgi için bkz. Nasıl Yapılır: Word Belgelerine Bookmark (Yer İşareti) Denetimi Ekleme.

Denetimlere Veri Bağlama

Microsoft.Office.Tools.Word.Bookmark denetimi basit veri bağlamasını destekler. Yer işareti, bir veri kaynağına DataBindings özelliği kullanılarak bağlanmalıdır. Yer işaretinin varsayılan veri bağlama özelliği Text özelliğidir.

Bağlanmış veri kümesindeki veriler güncellenirse, Microsoft.Office.Tools.Word.Bookmark denetimi değişiklikleri yansıtır.

Belge düzeyi projelerinde Veri Kaynağı penceresini kullanarak yer işaretlerine veri bağlayabilirsiniz. Daha fazla bilgi için bkz. Nasıl Yapılır: Nesnelerden Gelen Veriyle Belgeleri Doldurma.

Biçimlendirme

Bir Microsoft.Office.Interop.Word.Bookmark'a uygulanabilen biçimlendirme Microsoft.Office.Tools.Word.Bookmark denetimine de uygulanabilir. Bu, yazı tiplerini, girintileri, aralığı, numaralandırmayı ve stilleri kapsar.

Yer işaretine Metni Atama

Microsoft.Office.Interop.Word.Bookmark nesnesi ve Microsoft.Office.Tools.Word.Bookmark denetimi arasındaki ek farklılık, metin yer işaretine atandığında onun nasıl davrandığıdır. Sıfır uzunluklu Microsoft.Office.Interop.Word.Bookmark'a metni atarsanız, metin yer işaretinin sağına eklenir ve yer işareti sıfır uzunlukta kalır. Fakat, eğer metni sıfır uzunluktaki Microsoft.Office.Tools.Word.Bookmark'a atarsanız, metin yer işaretine eklenir ve yer işaretinin uzunluğu eklenen karakterlerin toplamı kadar genişletilir.

Microsoft.Office.Tools.Word.Bookmark denetimi, Bookmark.Text özelliğine de sahiptir. Bu, Microsoft.Office.Tools.Word.Bookmark denetiminin Range özelliğinde veya Microsoft.Office.Interop.Word.Bookmark nesnesinin Range özelliğinde kullanılabilir olan Range.Text özelliğinden farklıdır.

Metin Özelliği	Açıklama
Bookmark.Text	Yer işareti içindeki metni görüntülemek ve yer işaretini belgede bırakmak için bu özelliği kullanın. Metni yer işaretine 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 sağlam bırakır.
Range.Text	Yer işareti konumundaki metni 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" metnini yer işaretine ekler ve yer işaretini siler.

Bookmark.Text

Yer işareti içindeki metni görüntülemek ve yer işaretini belgede bırakmak için bu özelliği kullanın. Metni yer işaretine 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 sağlam bırakır.

Range.Text

Yer işareti konumundaki metni 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" metnini yer işaretine ekler ve yer işaretini siler.

Tasarım Zamanında Denetimi Yeniden Adlandırma

Belge düzeyi projelerinde Araç Kutusu'ndan belgenize Microsoft.Office.Tools.Word.Bookmark denetimi sürüklediğinizde, Visual Studio otomatik olarak denetim için bir isim yaratır. Özellikler penceresini kullanarak denetimin adını değiştirebilirsiniz.

Örtüşen Denetimler

Yer işareti denetimleri birbirleriyle örtüşebilir; aynı metin birden çok yer işareti tarafından paylaşılabilir. Yeni metni örtüşen yer işaretlerinden birine atadığınızda, o sadece yeni metni ve artık örtüşmeyen metni içerir. Diğer yer işareti sadece örtüşen özgün yer işaretleri arasında paylaşılmayan metni içerir.

Aşağıdaki tabloda gösterildiği nasıl cümle "Bu örnek metindir." iki çakışan yer tarafından paylaşılır.

Yer işareti	Metin
Örtüşen yer işaretleri	[this is {sample] text.}
Bookmark1	This is sample
Bookmark2	sample text.

Eğer yeni "This is replacement." metnini Bookmark1'e atarsanız, yer işaretleri artık örtüşmez ve Bookmark2, Bookmark1'in özgün olarak parçası olmayan metni saklar.

Yer işareti	Text
İki ayrı yer işareti	[this is replacement]{ text.}
Bookmark1	This is replacement
Bookmark2	text.

Eğer bir yer işareti diğer yer işaretiyle doldurulmuşsa ve metni dış yer işaretiyle değiştiriyorsanız, içteki yer işareti silinmez. Fakat, içteki yer işareti, dıştaki yer işaretinin sonuna taşınan boş bir yer işaretine dönüşür. Aşağıdaki tabloda "This is sample text." cümlesinin, başka bir yer işareti tarafından kapsanan bir yer işareti tarafından nasıl paylaşıldığı gösterilir.

Yer işareti	Text
Örtüşen yer işaretleri	[this is {sample} text.]
Bookmark1	This is sample text.
Bookmark2	sample

Eğer yeni "This is replacement." metnini Bookmark1'e atarsanız, yer işaretleri artık örtüşmez ve Bookmark2, Bookmark1'in sonunda konumanan boş bir yer işaretine dönüşür.

Yer işareti	Text
İki ayrı yer işareti	[this is replacement.]{}
Bookmark1	This is replacement.
Bookmark2	<empty>

Olaylar

Aşağıdaki olaylar Microsoft.Office.Tools.Word.Bookmark denetimi için kullanılabilir:

Ayrıca bkz.

Aracılığıyla paylaş

Yer İşareti Denetimi

Denetimlere Veri Bağlama

Biçimlendirme

Yer işaretine Metni Atama

Tasarım Zamanında Denetimi Yeniden Adlandırma

Örtüşen Denetimler

Olaylar

Ayrıca bkz.

Görevler

Kavramlar

Diğer Kaynaklar

Ek kaynaklar