Nasıl Yapılır: Word Belgelerine Bookmark (Yer İşareti) Denetimi Ekleme
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 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ü.
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. 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.
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. Office Belgelerinde Dinamik Denetimleri Kalıcı Kılma.
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.
' Use the following line of code in projects that target the .NET Framework 4. Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument) ' In projects that target the .NET Framework 3.5, use the following line of code. ' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject() Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _ extendedDocument.Paragraphs(1).Range, "FirstParagraph")
// Use the following line of code in projects that target the .NET Framework 4. Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument); // In projects that target the .NET Framework 3.5, use the following line of code. // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject(); 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) ' Use the following line of code in projects that target the .NET Framework 4. Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument) ' In projects that target the .NET Framework 3.5, use the following line of code. ' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject() 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); // Use the following line of code in projects that target the .NET Framework 4. Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument); // In projects that target the .NET Framework 3.5, use the following line of code. // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject(); Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark( firstBookmark, "VSTOBookmark"); }
Ayrıca bkz.
Görevler
Nasıl Yapılır: Yer İşarti Denetimlerinin Boyutunu Değiştirme
Kavramlar
Genişletilmiş Nesneleri Kullanarak Word'ü Otomatikleştirme
Konak Öğeleri ve Konak Kontrollerine Genel Bakış
Belgeye Çalışma Zamanında Denetim Ekleme
Ana Bilgisayar Öğelerinin ve Ana Bilgisayar Denetimlerinin Programsal Sınırlamaları
Ana Bilgisayar Denetimleri İçin Yardımcı Yöntemler