Nasıl Yapılır: Office Belgelerine Windows Forms Denetimleri Ekleme

Makale
06/10/2015

Belge düzeyi projelerinde Windows Forms denetimlerini Microsoft Office Excel ve Microsoft Office Word belgelerine tasarım zamanında ekleyebilirsiniz.Çalışma anında, belge düzeyi özelleştirmelerine ve uygulama düzeyi eklentilerine denetim ekleyebilirsiniz.Örneğin, bir ComboBox denetimini kullanıcıların bir seçenek listesinden seçim yapabilmesini sağlamak için çalışma sayfanıza ekleyebilirsiniz.

Uygulama hedefi: Bu konudaki bilgiler, şu uygulamalar için belge düzeyi projeler ve uygulama düzeyi projelere yöneliktir. Excel 2013 ve Excel 2010; Word 2013 ve Word 2010. 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 denetim ekleme
Belge düzeyi projelerinde çalışma zamanında denetim ekleme
Uygulama düzeyi eklentilerinde çalışma zamanında denetim ekleme

video bağlantısı İlgili video gösterimi için bkz: nasıl yapmak ı: eklemek denetimleri çalışma zamanında bir belge yüzeyine?.

Çalışma Zamanında Denetim Ekleme

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

[!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.

Belgeye Windows Forms denetimi sürüklemek için

Belgenin tasarımcıda görünür olması için Visual Studio'da Excel Çalışma Kitabı projesi ya da Word Belge projesi oluşturun ya da açın.Proje oluşturma hakkında bilgi için, bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.
Araç Kutusu'nun Ortak Denetimler sekmesinde eklemek istediğiniz denetimi tıklatın ve belgeye sürükleyin.

[!NOT]

Excel'de denetim seçtiğinizde, Formula Bar'da (Formül Çubuğu) =EMBED("WinForms.Control.Host","") göreceksiniz.Bu metin gereklidir ve silinmemelidir.

Belgenin üzerine Windows Forms denetimi çizmek için

Belgenin tasarımcıda görünür olması için Visual Studio'da Excel Çalışma Kitabı projesi ya da Word Belge projesi oluşturun ya da açın.Proje oluşturma hakkında bilgi için, bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.
Araç Kutusu'nun Ortak Denetimler sekmesinde eklemek istediğiniz denetimi tıklatın.
Belgenin üzerinde denetimin sol üst köşesinin konumlanmasını istediğiniz yeri tıklatın ve denetimin sağ al köşesinin konumlanmasını istediğiniz yere kadar sürükleyin.

Denetim, belgeye belirlenen konum ve boyutla eklenir.

[!NOT]

Excel'de denetim seçtiğinizde, Formula Bar'da (Formül Çubuğu) =EMBED("WinForms.Control.Host","") göreceksiniz.Bu metin gereklidir ve silinmemelidir.

Belgeye Windows Forms denetimini denetime tek tıklatarak eklemek için

Belgenin tasarımcıda görünür olması için Visual Studio'da Excel Çalışma Kitabı projesi ya da Word Belge projesi oluşturun ya da açın.Proje oluşturma hakkında bilgi için, bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.
Araç Kutusu'nun Ortak Denetimler sekmesinde eklemek istediğiniz denetimi tıklatın.
Belgenin üzerinde denetimi eklemek istediğiniz yeri tıklatın.

Denetim, belgeye varsayılan konum ve boyutla eklenir.

[!NOT]

Excel'de denetim seçtiğinizde, Formula Bar'da (Formül Çubuğu) =EMBED("WinForms.Control.Host","") göreceksiniz.Bu metin gereklidir ve silinmemelidir.

Belgeye Windows Forms denetimini denetime çift tıklatarak eklemek için

Belgenin tasarımcıda görünür olması için Visual Studio'da Excel Çalışma Kitabı projesi ya da Word Belge projesi oluşturun ya da açın.Proje oluşturma hakkında bilgi için, bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.
Araç Kutusu'nun Ortak Denetimler sekmesinde eklemek istediğiniz denetimi çift tıklatın.

Denetim, belgenin veya etkin bölmenin ortasına eklenir.

[!NOT]

Excel'de denetim seçtiğinizde, Formula Bar'da (Formül Çubuğu) =EMBED("WinForms.Control.Host","") göreceksiniz.Bu metin gereklidir ve silinmemelidir.

Belgeye Windows Forms denetimini ENTER tuşuna basarak eklemek için

Belgenin tasarımcıda görünür olması için Visual Studio'da Excel Çalışma Kitabı projesi ya da Word Belge projesi oluşturun ya da açın.Proje oluşturma hakkında bilgi için, bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.
Araç Kutusu'nun Ortak Denetimler sekmesinde eklemek istediğiniz denetimi tıklatın ve ENTER tuşuna basın.

Denetim, belgenin veya etkin bölmenin ortasına eklenir.

[!NOT]

Excel'de denetim seçtiğinizde, Formula Bar'da (Formül Çubuğu) =EMBED("WinForms.Control.Host","") göreceksiniz.Bu metin gereklidir ve silinmemelidir.

Belge Düzeyi Projelerinde Çalışma Zamanında Denetim Ekleme

Windows Forms denetimlerini bir belgeye çalışma zamanında program aracılığıyla ekleyebilirsiniz.Word'de ThisDocument sınıfının Controls özelliğinin yöntemlerini kullanın.Excel'de Sheetn sınıfının Controls özelliğinin yöntemlerini kullanın.Her yöntemin, denetimin konumunu farklı yollarla seçmenize olanak tanıyan birkaç yüklemesi vardır.

Belgeye çalışma zamanında bir Windows Forms denetimi eklediğinizde, denetim belge kapandığı zaman belgede kalıcı olmaz.Denetimi belgenin bir sonraki açılışında tekrar oluşturabilirsiniz.Daha fazla bilgi için bkz. Office Belgelerine Çalışma Zamanında Denetim Ekleme.

Belgeye çalışma zamanında Windows Forms denetimi eklemek için

Add<denetim sınıfı> adındaki bir yöntemi kullanın. (Burada denetim sınıfı, eklemek istediğiniz Windows Forms denetiminin sınıf adıdır. Örn. AddButton.)

Aşağıdaki kod örneğinde, bir belge düzeyi Excel projesinde Sheet1 sayfasının C5 hücresine naıl Button ekleneceği gösterilmektedir.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    Dim salesButton As Microsoft.Office.Tools.Excel.Controls.Button
    salesButton = Me.Controls.AddButton(Me.Range("C5"), "salesButton")
    salesButton.Text = "Calculate Total Sales" 
End Sub

private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button salesButton;
    salesButton = this.Controls.AddButton(this.get_Range("C5"), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

Uygulama Düzeyi Eklentilerinde Çalışma Zamanında Denetim Ekleme

Windows Forms denetimlerini açık herhangi bir belgeye çalışma zamanında program aracılığıyla ekleyebilirsiniz.İlk önce, açık bir belgeye veya çalışma sayfasına dayanan bir konak öğesi oluşturun.Sonra, Word'de, yeni konak öğesinin Document.Controls özelliğinin yöntemlerini kullanın.Excel'de, yeni konak öğesinin Worksheet.Controls özelliğinin yöntemlerini kullanın.Her yöntemin, denetimin konumunu farklı yollarla seçmenize olanak tanıyan birkaç yüklemesi vardır.

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.

Belgeye çalışma zamanında Windows Forms denetimi eklemek için

Add<denetim sınıfı> adındaki bir yöntemi kullanın. (Burada denetim sınıfı, eklemek istediğiniz Windows Forms denetiminin sınıf adıdır. Örn. AddButton.)

[!NOT]

Uygulama Düzeyi Eklentilerindeki hedefleyen projelerde .NET Framework 4 veya .NET Framework 4,5, erişebilmek için önce Microsoft.Office.Tools.Excel.v4.0.Utilities.dll veya Microsoft.Office.Tools.Word.v4.0.Utilities.dll derlemesine bir başvuru eklemeniz gerekir Add<Denetim sınıfı> yöntemleri.

Aşağıdaki kod örneğinde etkin belgenin ilk paragrafına bir Word eklentisi kullanarak Button'ın nasıl ekleneceği gösterilmektedir.

Dim salesButton As Microsoft.Office.Tools.Word.Controls.Button

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

extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
salesButton = extendedDocument.Controls.AddButton( _
    extendedDocument.Paragraphs(1).Range, 75, 18, "salesButton")
salesButton.Text = "Calculate Sales"

Microsoft.Office.Tools.Word.Controls.Button salesButton;

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


extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
salesButton = extendedDocument.Controls.AddButton(
    extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
salesButton.Text = "Calculate Sales";