İzlenecek Yol: Windows Formu Kullanarak Veri Toplama

Makale
06/10/2015

Bu anlatım Microsoft Office Excel için bir belge düzeyi özelleştirmesinden nasıl bir Windows Form açıldığını, nasıl kullanıcıdan bilgi toplanıldığını ve bu bilginin çalışma sayfası hücresine nasıl yazıldığını gösterir.

Uygulama hedefi: Bu konudaki bilgiler, Office 2013 ve Office 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.

Burada özellikle Excel için bir belge düzeyi projesi kullanılıyor olsa da, izlenecek yol tarafından gösterilen kavramlar diğer Office projelerine uygulanabilir.

Önkoşullar

Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:

Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2013 sürümü. Daha fazla bilgi edinmek için, bkz. Office Çözümleri Geliştirmek İçin Bilgisayarı Yapılandırma.
Excel 2013 veya Excel 2010.

[!NOT]

Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arayüzü öğ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'da Geliştirme Ayarlarını özelleştirme.

Yeni Bir Proje Oluşturma

İlk adım, bir Excel Çalışma Kitabı projesi oluşturamaktır.

Yeni bir proje oluşturmak için

GirdiWinFormu adında bir Excel çalışma kitabı projesi oluşturun ve seçin Yeni Belge Oluştur Sihirbazı'nda.Daha fazla bilgi için bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.

Visual Studio tasarımcıda yeni Excel çalışma kitabını açar ve Çözüm Gezgini'ne girdiWinFormu projesini ekler.

Çalışma Sayfasına NamedRange Denetimi Ekleme

Sheet1'e adlandırılmış bir aralık eklemek için

Sheet1'de A1 hücresini seçin.
İçinde adı kutusuna girdiFormu yazın.

Ad kutusu formül çubuğunun sol tarafında, çalışma sayfasının A sütununun hemen üstünde bulunur.
ENTER tuşuna basın.

Bir NamedRange denetimi A1 hücresine eklenir.Çalışma sayfasında görünür bir gösterge yoktur, fakat A1 hücresi seçili olduğunda Ad kutusunda (çalışma sayfasının hemen üstünde sol tarafta) ve Özellikler penceresinde girdiFormu belirir.

Projeye Windows Form Ekleme

Kullanıcıdan bilgi almak için bir Windows From istemi oluşturun.

Bir Windows Form eklemek için

Çözüm Gezgini içinde, girdiWinFormu projesini seçin.
Project (Proje) menüsünde, Add Windows Form'u (Windows Form Ekle) tıklatın.
Formu GetInputString.vb veya GetInputString.cs olarak adlandırın ve Ekle'yi tıklatın.

Yeni form tasarımcıda açılır.
Forma bir TextBox ve Button ekleyin.
Düğmeyi seçin, Özellikler penceresinde Text özelliğini bulun ve metni OK olarak değiştirin.

Ardından, ThisWorkbook.vb veya ThisWorkbook.cs'e kullanıcının bilgisini toplamak için kod ekleyin.

Windows Form'u Görüntüleme ve Bilgi Toplama

GetInputString Windows Form'unun olgusunu oluşturun ve görüntüleyin; ardından kullanıcının bilgisini çalışma sayfasındaki bir hücreye yazın.

Formu görüntülemek ve bilgi toplamak için

Çözüm Gezgini'nde ThisWorkbook.cs veya ThisWorkbook.vb'ye sağ tıklatın ve sonra Kodu Göster'i tıklatın.

ThisWorkbook'un Open olay işleyicisine GetInputString formu için bir değişken bildirmek üzere aşağıdaki kodu ekleyin ve formu gösterin.

[!NOT]

C#'ta, Startup olayına bir olay işleyicisini aşağıdaki gibi eklemelisiniz.Olay işleyicisi oluşturma hakkında daha fazla bilgi için, bkz. Nasıl Yapılır: Office Projelerinde Olay İşleyicileri Oluşturma.

Private Sub ThisWorkbook_Open() Handles Me.Open
    Dim inputForm As New GetInputString()
    inputForm.ShowDialog()
End Sub

private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    this.Open += new 
        Microsoft.Office.Interop.Excel.WorkbookEvents_OpenEventHandler(ThisWorkbook_Open);
}

private void ThisWorkbook_Open()
{
    GetInputString inputForm = new GetInputString();
    inputForm.ShowDialog();
}

Bir adlandırılmış aralığa metin yazan WriteStringToCell adında bir yöntem oluşturun.Bu yöntem formdan çağrılır ve kullanıcının girdisi NamedRange denetimine, A1 hücresinde formInput'a geçirilir.

Public Sub WriteStringToCell(ByVal formData As String)
    Globals.Sheet1.formInput.Value2 = formData
End Sub

public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}

Ardından, düğmenin tıklatma olayını işleyen forma kod ekleyin.

Çalışma Sayfasına Bilgi Gönderme

Çalışma sayfasına bilgi göndermek için

Solution Explorer'da GetInputString'i sağ tıklatın ve ardından Görünüm Tasarımcısı'nı tıklatın.
Düğmenin Click olayı işleyicisi eklenmiş kod dosyasını açmak için düğmeye çift tıklayın.

Metin kutusundan girdiyi almak, bunu WriteStringToCell işlevine göndermek ve formu kapamak için kod ekleyin.

Globals.ThisWorkbook.WriteStringToCell(Me.TextBox1.Text)
Me.Dispose()

Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();

Sınama

Projeyi artık çalıştırabilirsiniz.Windows Form görünür ve girdiniz çalışma sayfasında belirir.

Çalışma kitabınızı sınamak için

F5 tuşuna basarak projeyi çalıştırın.
Windows Form'un göründüğünü onaylayın.
Hello World metin kutusuna yazın ve ardından Tamam.
Hello World hücresinde göründüğünü onaylayın A1 çalışma.

Sonraki Adımlar

Bu anlatım, bir Windows Form'u göstermenin ve çalışma sayfasına veri geçirmenin temellerini gösterir.Gerçekleştirmek isteyebileceğiniz diğer görevler arasında şunlar yer alır:

Bir Excel çalışma kitabında ya da Word belgesinde Windows Forms denetimleri kullanma.Daha fazla bilgi için bkz. Office Belgelerindeki Windows Forms Denetimlerine Genel Bakış.
Belge düzeyi özelleştirmesinden veya uygulama düzeyi eklentisinden bir Microsoft Office uygulamasının kullanıcı arabirimini değiştirme.Daha fazla bilgi için bkz. Office Kullanıcı Arabirimini Özelleştirme.