Nasıl yapılır: Windows Forms denetimleri eklemek için Office belgeleri

Makale
02/26/2013

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 alanı: Bu konudaki bilgiler şu uygulamaların belge düzeyi projelerine ve uygulama düzeyi projelerine yöneliktir: Excel 2013 ve Excel 2010; Word 2013 ve Word 2010. 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 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ı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ı.

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 Office projeler oluşturmak.
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 Office projeler oluşturmak.
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 Office projeler oluşturmak.
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 Office projeler oluşturmak.
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 Office projeler oluşturmak.
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. Belgeye Ç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. Word Belgelerini ve Excel Çalışma Kitaplarını Çalıştırma Zamanında Uygulama Düzeyi Eklentileri İçinde 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";