İzlenecek Yol: Özel Görev Bölmesini Şerit Düğmesi ile Eşitleme

Makale
06/10/2015

İzlenecek bu yol, kullanıcıların Şerit'te iki durumlu düğmeye tıklayarak saklayabileceği ya da görüntüleyebileceği özel görev bölmelerinin nasıl yaratılacağını göstermektedir.Kullanıcıların özel görev bölmenizi görüntülemek ya da gizlemek için tıklayacakları bir kullanıcı ara birimi ögesi (örneğin bir düğme) oluşturmanız gerekir; çünkü Microsoft Office uygulamaları kullanıcılara özel görev bölmelerini gizlemek ya da görüntülemek için varsayılan bir yol sağlamaz.

Uygulama hedefi: Bu konudaki bilgiler, Outlook 2013 ve Outlook 2010 için 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.

Bu yol özellikle Excel kullanıyor olsa da, izlenecek yol tarafından gösterilen kavramlar yukarıda listelenen uygulamaların hepsine uygulanabilir.

Bu örneklerde aşağıdaki görevler gösterilir:

Özel görev bölmesinin kullanıcı ara birimini tasarlama
Şerit'e iki durumlu düğme ekleme
İki durumlu düğmeyi özel görev bölmesiyle eşitleme

[!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.
Microsoft Excel 2010 veya Microsoft Excel 2013.

Eklenti Projesi Oluşturma

Bu adımda, Excel için bir eklenti projesi oluşturacaksınız.

Yeni bir proje oluşturmak için

Excel Eklenti projesi şablonunu kullanarak, SynchronizeTaskPaneAndRibbon isimli bir Excel Eklenti projesi oluşturun.Daha fazla bilgi için bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.

Visual Studio ThisAddIn.cs ya da ThisAddIn.vb kod dosyasını açar ve SynchronizeTaskPaneAndRibbon projesini Çözüm Gezgini'ne ekler.

Şerit'e iki durumlu düğme ekleme

Office uygulaması tasarım yönergelerinden biri, kullanıcıların Office uygulaması kullanıcı arabirimini her zaman denetlemeleri gerektiğidir.Kullanıcıların özel görev bölmelerini denetleyebilmelerini sağlamak için, görev bölmesini gizleyen ve görüntüleyen bir Şerit iki durumlu düğmesi ekleyebilirsiniz.İki durumlu düğme yaratmak için, projeye Şerit (Görsel Tasarımcı) ögesi ekleyin.Tasarımcı denetim eklemenize ve yerleştirmenize, denetim özelliklerini ayarlamanıza ve denetim olaylarını yönetmenize yardımcı olur.Daha fazla bilgi için bkz. Şerit Tasarımcısı.

Şerit'e iki durumlu düğme ekleme

Proje menüsünde, Yeni Öğe Ekle'yi tıklatın.
Yeni Öge Ekle iletişim kutusunda, Şerit (Görsel Tasarımcı)'yı seçin.
Yeni Şerit'in adını ManageTaskPaneRibbon olarak değiştirin ve Ekle'ye tıklayın.

ManageTaskPaneRibbon.cs ya da ManageTaskPaneRibbon.vb dosyası Şerit Tasarımcısı'nda açılır ve varsayılan bir sekme ve grup görüntüler.
Şerit Tasarımcısı'nda group1'e tıklayın.
İçinde özelliklerini penceresinde, etiketi özelliği için Görev Bölmesi Yöneticisi.
Araç Kutusu'nun Office Şerit Denetimleri sekmesinden, Görev Bölmesi Yöneticisi grubuna bir ToggleButton sürükleyin.
toggleButton1'e tıklayın.
İçinde özelliklerini penceresinde, etiketi özelliği için görev bölmesini göster.

Özel Görev Bölmesinin Kullanıcı Arayüzünü Tasarlama

Özel görev bölmeleri için görsel tasarımcı yoktur, ancak istediğiniz düzende bir kullanıcı denetimi tasarlayabilirsiniz.İzlenecek bu yolun ilerleyen aşamalarında, özel görev bölmesine kullanıcı denetimi ekleyeceksiniz.

Özel görev bölmesinin kullanıcı arayüzünü tasarlamak için

Proje menüsünde, Kullanıcı Denetimi Ekle'ye tıklayın.
Yeni Öge Ekle iletişim kutusunda, kullanıcı denetiminin adını TaskPaneControl olarak değiştirin ve Ekle'ye tıklayın.

Kullanıcı denetimi tasarımcıda açılır.
Araç Kutusu'nun Genel Denetimler sekmesinden, kullanıcı denetimine bir TextBox sürükleyin.

Özel Görev Bölmesi Oluşturma

Eklenti başladığında özel görev bölmesi oluşturmak için, eklentinin Startup olay işleyicisinde görev bölmesine kullanıcı denetimini ekleyin.Varsayılan olarak, özel görev bölmeleri ekranda görünmez.İzlenecek bu yolun sonraki aşamalarında, kullanıcı Şerit'e eklediğiniz iki durumlu düğmeye tıkladığında görev bölmesini gizleyen ya da görüntüleyen bir kod ekleyeceksiniz.

Özel görev bölmesi oluşturmak için

Çözüm Gezgini'nde Excel'i genişletin.
ThisAddIn.cs ya da ThisAddIn.vb'ye sağ tıklayın ve Kodu Görüntüle'ye tıklayın.

Aşağıdaki kodu ThisAddIn sınıfına ekleyin.Bu kod TaskPaneControl'ü ThisAddIn'in bir örneği olarak tanımlar.

Private taskPaneControl1 As TaskPaneControl
Private WithEvents taskPaneValue As Microsoft.Office.Tools.CustomTaskPane

private TaskPaneControl taskPaneControl1;
private Microsoft.Office.Tools.CustomTaskPane taskPaneValue;

ThisAddIn_Startup olay işleyicisini aşağıdaki kod ile değiştirin.Bu kod TaskPaneControl nesnesini CustomTaskPanes alanına ekler, ancak özel görev yöneticisini görüntülemez (varsayılan olarak, CustomTaskPane sınıfının Visible özelliği false olarak ayarlıdır).Visual C# kodu ayrıca VisibleChanged olayına bir olay işleyicisi ekler.

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

    taskPaneControl1 = New TaskPaneControl()
    taskPaneValue = Me.CustomTaskPanes.Add( _
        taskPaneControl1, "MyCustomTaskPane")
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    taskPaneControl1 = new TaskPaneControl();
    taskPaneValue = this.CustomTaskPanes.Add(
        taskPaneControl1, "MyCustomTaskPane");
    taskPaneValue.VisibleChanged +=
        new EventHandler(taskPaneValue_VisibleChanged);
}

Aşağıdaki yöntemi ThisAddIn sınıfına ekleyin.Bu yöntem VisibleChanged olayını işler.Kullanıcı Kapat (X) düğmesine tıklayarak görev bölmesini kapadığında, bu yöntem Şerit'teki iki durumlu düğmenin durumunu günceller.

Private Sub taskPaneValue_VisibleChanged(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles taskPaneValue.VisibleChanged

    Globals.Ribbons.ManageTaskPaneRibbon.ToggleButton1.Checked = taskPaneValue.Visible
End Sub

private void taskPaneValue_VisibleChanged(object sender, System.EventArgs e)
{
    Globals.Ribbons.ManageTaskPaneRibbon.toggleButton1.Checked = 
        taskPaneValue.Visible;
}

Aşağıdaki özelliği ThisAddIn sınıfına ekleyin.Bu özellik özel myCustomTaskPane1 nesnesini öbür sınıfların kullanımına sunar.İzlenecek bu yolun ilerleyen aşamalarında, MyRibbon sınıfına bu özelliği kullanan bir kod ekleyeceksiniz.

Public ReadOnly Property TaskPane() As Microsoft.Office.Tools.CustomTaskPane
    Get 
        Return taskPaneValue
    End Get 
End Property

public Microsoft.Office.Tools.CustomTaskPane TaskPane
{
    get
    {
        return taskPaneValue;
    }
}

İki Durumlu Düğmeyi Kullanarak Özel Görev Bölmesini Gizleme ve Görüntüleme

Son aşama, kullanıcı Şerit'teki iki durumlu düğmeye tıkladığında özel görev bölmesini gizleyen ya da görüntüleyen kodu eklemedir.

İki durumlu düğmeyi kullanarak özel görev bölmesini gizlemek ve görüntülemek için

Şerit Tasarımcısı'nda, Görev Bölmesini Göster iki durumlu düğmesine çift tıklayın.

Visual Studio otomatik olarak iki durumlu düğmenin Click olayını işleyen, toggleButton1_Click adlı bir olay işleyicisi oluşturur.Visual Studio ayrıca Kod Düzenleyicisi'nde MyRibbon.cs ya da MyRibbon.vb dosyasını açar.

toggleButton1_Click olay işleyicisini aşağıdaki kod ile değiştirin.Kullanıcı iki durumlu düğmeye tıkladığında, bu kod iki durumlu düğmeye basılıp basılmadığına bağlı olarak, özel görev bölmesini gizler ya da görüntüler.

Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles ToggleButton1.Click

    Globals.ThisAddIn.TaskPane.Visible = _
        TryCast(sender, Microsoft.Office.Tools.Ribbon.RibbonToggleButton).Checked
End Sub

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisAddIn.TaskPane.Visible = ((RibbonToggleButton)sender).Checked;
}

Eklentiyi Test Etme

Projenizi çalıştırdığınızda, özel görev bölmesi görüntülenmeden Excel açılır.Kodu sınamak için Şerit'teki iki durumlu düğmeye tıklayın.

Eklentiyi sınamak için

F5 tuşuna basarak projeyi çalıştırın.

Excel'in açık olduğunu ve Şerit'te Eklentiler sekmesinin göründüğünü onaylayın.
Şerit'te Eklentiler sekmesine tıklayın.
Görev Bölmesi Yöneticisi grubunda, Görev Bölmesini Göster iki durumlu düğmesine tıklayın.

İki durumlu düğmeye tıkladığınızda görev bölmesinin dönüşümlü olarak gizlendiğini ve görüntülendiğini doğrulayın.
Görev bölmesi görünüyorsa, görev bölmesinin köşesindeki Kapat (X) düğmesine tıklayın.

İki durumlu düğmenin basılamaz olduğunu doğrulayın.

Sonraki Adımlar

Aşağıdaki konulardan özel görev bölmelerinin nasıl oluşturulacağı hakkında daha fazla bilgi alabilirsiniz:

Farklı bir uygulama için bir eklentide özel görev bölmesi oluşturun.Özel görev bölmelerini destekleyen uygulamalar hakkında daha fazla bilgi için, bkz. Özel Görev Bölmeleri
Bir uygulamayı özel görev bölmesinden otomatikleştirin.Daha fazla bilgi için bkz. İzlenecek Yol: Uygulamayı Özel Görev Bölmesinden Otomatikleştirme.
Outlook'ta açılmış her e-posta iletisi için özel görev bölmesi oluşturun.Daha fazla bilgi için bkz. İzlenecek Yol: Outlook'ta E-Posta İletileri ile Birlikte Özel Görev Bölmelerini Görüntüleme.