İzlenecek Yol: Eylemler Bölmesinden Belgeye Metin Ekleme

Makale
06/10/2015

Bu anlatım Microsoft Office Word belgesi içinde nasıl eylemler bölmesi oluşturacağınızı gösterir.Eylemler bölmesi girdiyi toplayan ve sonra metni belgeye göndereyen iki denetimi içerir.

Uygulama hedefi: Bu konudaki bilgiler, Word 2013 ve Word 2010 için belge 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 örneklerde aşağıdaki görevler gösterilir:

Eylemler bölmesi denetimleri üzerinde Windows Forms denetimleri kullanarak arabirim tasarlama.
Uygulama açıldığında eylemler bölmesini görüntüleme.

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

Ö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.
Word 2013 veya Word 2010.

Projeyi Oluşturma

İlk adım Word Belge projesi oluşturmaktır.

Yeni bir proje oluşturmak için

My Basic Actions Pane adında bir Word Belge projesi oluşturun.Sihirbazda Create a new document'ı (Yeni belge oluştur) seçin.Daha fazla bilgi için bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.

Visual Studio yeni Word belgesini tasarımcıda açar ve My Basic Actions Pane projesini Solution Explorer'a (Çözüm Gezgini) ekler.

Belgeye Metin ve Yer İşaretleri Ekleme

Eylem bölmesi belgedeki yer işaretlerine metni gönderecektir.Belgeyi tasarlamak için temel form oluşturmak üzere birtakım metinler yazın.

Belgenize metin ekleme

Aşağıdaki metni Word belgenize yazın:

21 Mart 2008

Ad

Adres

Bu Word basit eylemler bölmesi örneğidir.

Visual Studio Toolbox'ından (Araç Kutusu) sürükleyerek veya Word Bookmark (Yer İşareti) iletişim kutusunu kullanarak belgenize Bookmark denetimi ekleyebilirsiniz.

Belgenize Yer İşareti denetimi eklemek için

Toolbox'ın (Araç Kutusu) Word Controls (Word Denetimleri) sekmesinden, belgenize bir Bookmark denetimi sürükleyin.

Add Bookmark Control (Yer İşareti Denetimi Ekle) iletişim kutusu görünür.
Paragraf işaretini seçmeden Name (Ad) sözcüğünü seçin ve OK'i (Tamam) tıklayın.

[!NOT]

Paragraf işareti yer işaretinin dışında olmak zorundadır.Paragraf işaretleri belgede görünür değilse Tools (Araçlar) menüsüne tıklayın, Microsoft Office Word Tools (Microsoft Office Word Araçları) üzerine gelin ve sonra Options'ı (Seçenekler) tıklayın.View (Görünüm) sekmesine tıklayın ve Options (Seçenekler) iletişim kutusunun Formatting marks (Biçimlendirme İşaretleri) bölümündeki Paragraph marks (Paragraf İşaretleri) onay kutusunu seçin.
Properties (Özellikler) penceresinde Bookmark1'ın Name (İsim) özelliğini showName olarak değiştirin.
Paragraf işaretini seçmeden Address (Adres) sözcüğünü seçin.
Şerit'in Links (Bağlantılar) grubunun Insert (Ekle) sekmesinde Bookmark'ı (Yer İşareti) tıklayın.
Bookmark (Yer İşareti) iletişim kutusunda Bookmark Name kutusuna showAddress yazın ve Add'i (Ekle) tıklayın.

Eylemler Bölmesine Denetim Ekleme

Eylemler bölmesi arabirimini tasarlamak için projeye bir eylemler bölmesi denetimi ekleyin ve daha sonra eylemler bölmesi denetimine Windows Forms denetimi ekleyin.

Eylemler bölmesi denetimi eklemek için

Solution Explorer'da (Çözüm Gezgini) My Basic Actions Pane projesini seçin.
Proje menüsünde, Yeni Öğe Ekle'yi tıklatın.
Add New Item (Yeni Öge Ekle) iletişim kutusunda, Actions Pane Control'e (Eylemler Bölmesi Denetimi) tıklayın ve denetimi InsertTextControl, olarak adlandırın, sonra da Add'i (Ekle) tıklayın.

Eylemler bölmesi denetimine Windows Form denetimi eklemek için

Eylemler bölmesi denetimi tasarımcıda görünür değilse InsertTextControl'ü çift tıklayın.
Toolbox'ın (Araç Kutusu) Common Controls (Genel Denetimler) sekmesinden, eylemler bölmesi denetimine bir Label (Etiket) sürükleyin.
Etiket denetiminin Text özelliğini Name olarak değiştirin.
Eylemler bölmesi denetimine Textbox denetimi ekleyin ve aşağıdaki özellikleri değiştirin.

Özellik

Value

Ad

getName

Size

130, 20
Eylemler bölmesi denetimine ikinci Label (Etiket) denetimini ekleyin ve Text (Metin) özelliğini Address olarak değiştirin.
Eylemler bölmesi denetimine ikinci Textbox denetimini ekleyin ve aşağıdaki özellikleri değiştirin.

Özellik

Value

Ad

getAddress

Accepts Return

True

Çoklu satır

True

Size

130, 40
Eylemler bölmesi denetimine Button (Düğme) denetimi ekleyin ve aşağıdaki özellikleri değiştirin.

Özellik

Value

Ad

addText

Text

Ekle

Özellik	Value
Ad	getName
Size	130, 20

Özellik	Value
Ad	getAddress
Accepts Return	True
Çoklu satır	True
Size	130, 40

Özellik	Value
Ad	addText
Text	Ekle

Belgeye Metin Eklemek için Kod Ekleme

Eylemler bölmesinde, metin kutularından metni belgedeki uygun Bookmark denetimlerine ekleyen kodu yazın.Globals sınıfını eylemler bölmesi üzerindeki denetimlerden belgedeki denetimlere erişmek için kullanabilirsiniz.Daha fazla bilgi için bkz. Office Projelerindeki Nesnelere Genel Erişim.

Eylemler bölmesinden belgedeki yer işaretlerine metin eklemek için

addText düğmesinin Click olay işleyicisine aşağıdaki kodu ekleyin.

Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles addText.Click

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If 

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If 

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

C#'ta düğme tıklaması için olay işleyicisi eklemelisiniz. Bu kodu IntializeComponent'ı çağırdıktan sonra InsertTextControl yapıcısına yerleştirin. Olay işleyicisi oluşturma hakkında daha fazla bilgi için, bkz. Nasıl Yapılır: Office Projelerinde Olay İşleyicileri Oluşturma.
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

Eylemler Bölmesini Göstermek için Kod Ekleme

Eylemler bölmesini göstermek için denetim koleksiyonuna oluşturduğunuz denetimi ekleyin.

Eylemler bölmesini göstermek için

ThisDocument sınıfında eylemler bölmesi denetiminin yeni bir olgusunu oluşturun.

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

ThisDocument sınıfının Startup olay işleyicisine aşağıdaki kodu ekleyin.

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

Uygulamayı Test Etme

Belge açıldığında eylemler bölmesinin açıldığını ve düğme tıklandığında metin kutularına yazılan metinlerin yer işaretlerine eklendiğini doğrulamak için belgenizi test edin.

Belgenizi test etmek için

F5 tuşuna basarak projeyi çalıştırın.
Eylemler bölmesinin görünür olduğunu doğrulayın.
Eylemler bölmesindeki metin kutularına adınızı ve adreslerinizi yazın ve Insert'e (Ekle) tıklayın.

Sonraki Adımlar

Sonradan gelebilecek bazı görevler:

Excel'de eylemler bölmesi oluşturma.Daha fazla bilgi için bkz. How to: Add an Actions Pane to Excel Workbooks.
Eylemler bölmesindeki denetimlere veri bağlama.Daha fazla bilgi için bkz. İzlenecek Yol: Word Eylemler Bölmesindeki Denetimlere Veri Bağlama.

Ayrıca bkz.

Aracılığıyla paylaş