Nasıl Yapılır: Word Belgelerine Yer İşareti Denetimi Ekleme

Makale
06/10/2015

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 hedefi: Bu konudaki bilgiler, Word 2013 ve Word 2010 için belge düzeyi projeler ve uygulama düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

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ız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazıları için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için, bkz. Visual Studio'da Geliştirme Ayarlarını özelleştirme.

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 Bookmark'ı) temel alan bir Bookmark ekleyin.

Belge kapatıldığında dinamik olarak oluşturulan Bookmark denetimleri kalıcı değildir.Fakat, yerel 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. Office Belgelerine Ç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 Bookmark'tan bir Bookmark denetimi oluşturmak istiyorsanız AddBookmark yöntemini kullanın ve var olan 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 Bookmark'ı) temel alan bir Bookmark ekleyin.

Uygulama düzeyi projelerinde konak öğeleri oluşturma hakkında daha fazla bilgi için, bkz. Uygulama Düzeyi Eklentilerindeki Word Belgelerini ve Excel Çalışma Kitaplarını Çalışma Zamanında 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 Bookmark'ı geçirin.

Aşağıdaki kod örneğinde, etkin belgedeki ilk 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ş