Nasıl yapılır: Word belgelerinde yer denetimleri ekleyin

Makale
02/26/2013

Belge düzeyi projelerinde Bookmark denetimlerini projenizdeki belgeye tasarım veya çalışma anında ekleyebilirsiniz.Belge düzeyi projeleri uygulamarında Bookmark denetimlerini herhangi bir açık belgeye çalışma anında ekleyebilirsiniz.

Uygulama alanı: Bu konudaki bilgiler Word 2013 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ü.

Bu konuda aşağıdaki görevler açıklanır:

Çalışma zamanında Bookmark (Yer işareti) denetimleri ekleme
Belge düzeyi projesinde çalışma zamanında Bookmark denetimleri ekleme
Uygulama düzeyi projesinde çalışma zamanında Bookmark denetimi ekleme

Bookmark denetimleri hakkında daha fazla bilgi için, bkz. Yer İşareti Denetimi.

Çalışma Zamanında Bookmark Denetimleri Ekleme

Bir belge düzeyi projesinde belgeye tasarım zamanında Bookmark denetimleri eklemenin birkaç yolu vardır.

Visual Studio Araç Kutusundan.

Bookmark denetimini belgenize Araç Kutusu'ndan sürükleyebilirsiniz.Bunu, Araç Kutusunu belgenize Windows Forms denetimleri eklemek için zaten kullanıyorsanız seçebilirsiniz.
Word'ün içinden.

Yerel yer işaretini eklediğiniz şekilde belgenize Bookmark denetimini ekleyebilirsiniz.Bu şekilde eklemenin yararı, denetimi oluşturduğunuz zaman adlandırabilmenizdir.
Veri Kaynakları penceresinden.

Veri Kaynakları penceresinden belgenize Bookmark denetimi sürükleyebilirsiniz.Bu, aynı zamanda denetimi veriye bağlamak istediğinizde yararlıdır.Veri Kaynakları penceresinden, bir Windows Forms denetimi eklediğiniz şekilde belgenize konak kontrolünü ekleyebilirsiniz.Daha fazla bilgi için bkz. Veri bağlama ve Windows Forms.

[!NOT]

Bilgisayarınızda, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazılarının adı veya konumu farklı gösterilebilir. Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler. Daha fazla bilgi için bkz: Visual Studio ayarları.

Araç Kutusundan belgeye bir Bookmark denetimi eklemek için

Araç kutusu'nu açın ve Word Denetimleri sekmesine tıklayın.
Belgeye bir Bookmark denetimi sürükleyin.

Yer İşareti Ekle iletişim kutusu görüntülenir.
Yer işaretinde bulundurmak istediğiniz metin veya diğer öğerleri seçin.
Tamam düğmesini tıklatın.

Varsayılan yer işareti adını kullanmak istemiyorsanız, Özellikler penceresinden adı değiştirebilirsiniz.

Word'deki belgenize Bookmark denetimi eklemek için

Visual Studio tasarımcısında bulunan belgede, yer işaretini nereye eklemek istiyorsanız imleci oraya koyun veya yer işaretinin içermesini istediğiniz metni seçin.
Şerit'in Bağlantılar grubunun Ekle sekmesinde Yer İşareti'ni tıklayın.
Yer İşareti iletişim kutusunda yeni yer işaretinin ismini yazın ve Ekle'yi tıklayın.

Belge Düzeyi Projesinde Çalışma Zamanında Bookmark Denetimleri Ekleme

Projenizdeki ThisDocument sınıfının Controls özelliğinin yöntemlerini kullanarak Bookmark denetimlerini çalışma zamanında belgenize programlı olarak ekleyebilirsiniz.Aşağıdaki yollarla Bookmark denetimi eklemek için kullanabilen iki tane yöntem yüklemesi vardır:

Belirlenen bir aralığa Bookmark ekleme.
Belgede yerel bir yer işaretini (yani bir Microsoft.Office.Interop.Word.Bookmark'ı) temel alan bir Bookmark ekleyin.

Belge kapatıldığında dinamik olarak oluşturulan Bookmark denetimleri kalıcı değildir.Fakat, yerel Microsoft.Office.Interop.Word.Bookmark denetimi belgede kalıcıdır.Belge sonraki seferde açıldığında yerel yer işareti denetimini temel alan Bookmark denetimini yeniden oluşturabilirsiniz.Daha fazla bilgi için bkz. Belgeye Çalışma Zamanında Denetim Ekleme.

Belgeye program aracılığıyla Bookmark denetimi eklemek için

Bookmark denetimini belgenizdeki ilk paragrafa eklemek için aşağıdaki kodu projenizdeki ThisDocument_Startup olay işleyicisine ekleyin.
```
Dim firstParagraph As Microsoft.Office.Tools.Word.Bookmark
firstParagraph = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "FirstParagraph")
```
```
Microsoft.Office.Tools.Word.Bookmark firstParagraph;
firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
    "FirstParagraph");
```
[!NOT]

Var olan bir Microsoft.Office.Interop.Word.Bookmark'tan bir Microsoft.Office.Tools.Word.Bookmark denetimi oluşturmak istiyorsanız AddBookmark yöntemini kullanın ve var olan Microsoft.Office.Interop.Word.Bookmark'ı geçirin.

Uygulama Düzeyi Projesinde Çalışma Zamanında Bookmark Denetimleri Ekleme

Uygulama düzeyi eklentileri kullanarak Bookmark denetimlerini açık herhangi bir belgeye program aracılığıyla ekleyebilirsiniz.Bunu yapmak için, açık olan belgeye bağlı olan Document konak öğesi yaratın ve bu konak öğesinin Controls özelliğinin yöntemlerini kullanın.Aşağıdaki yollarla Bookmark denetimi eklemek için kullanabilen iki tane yöntem yüklemesi vardır:

Belirlenen bir aralığa Bookmark ekleme.
Belgede yerel bir yer işaretini (yani bir Microsoft.Office.Interop.Word.Bookmark'ı) temel alan bir Bookmark ekleyin.

Uygulama düzeyi projelerinde konak öğeleri oluşturma hakkında daha fazla bilgi için, bkz. Word Belgelerini ve Excel Çalışma Kitaplarını Çalıştırma Zamanında Uygulama Düzeyi Eklentileri İçinde Genişletme.

Belirlenmiş bir aralığa Bookmark denetimi eklemek için

ControlCollection.AddBookmark(Range, String) yöntemini kullanın ve Bookmark'ı eklemek istediğiniz yer olan Range'i geçirin.

Aşağıdaki kod örneğnde etkin belgenin başına yeni bir Bookmark eklenir.Bu örneği kullanmak için, bir Word eklenti projesinde kodu ThisAddIn_Startup olay işleyicisinden çalıştırın.

Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)


Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
    extendedDocument.Paragraphs(1).Range, "FirstParagraph")

Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
    extendedDocument.Paragraphs[1].Range, "FirstParagraph");

Belgedeki yerel Bookmark denetimine bağlı bir Bookmark denetimi eklemek için

ControlCollection.AddBookmark(Bookmark, String) yöntemini kullanın ve yeni Bookmark için temel olarak kullanmak istediğiniz mevcut Microsoft.Office.Interop.Word.Bookmark'ı geçirin.

Aşağıdaki kod örneğinde, etkin belgedeki ilk Microsoft.Office.Interop.Word.Bookmark'ı temel alan yeni bir Bookmark oluşturulur.Bu örneği kullanmak için, bir Word eklenti projesinde kodu ThisAddIn_Startup olay işleyicisinden çalıştırın.

If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then
    Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)

    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

    Dim vstoBookmark As Bookmark = extendedDocument.Controls.AddBookmark( _
        firstBookmark, "VSTOBookmark")
End If

if (this.Application.ActiveDocument.Bookmarks.Count > 0)
{
    object index = 1;
    Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);


     Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
            firstBookmark, "VSTOBookmark");
}

Ayrıca bkz.

Aracılığıyla paylaş