Aracılığıyla paylaş

İzlenecek yol: Şerit düğmesiyle özel görev bölmesini eşitleme

  • Makale

Bu kılavuzda, şeritteki iki durumlu düğmeyi tıklatarak kullanıcıların gizleyebileceği veya görüntüleyebileceği özel bir görev bölmesinin nasıl oluşturulacağı gösterilmektedir. Microsoft Office uygulaması lications, kullanıcıların özel görev bölmelerini göstermesi veya gizlemesi için varsayılan bir yol sağlamadığından, kullanıcıların özel görev bölmenizi görüntülemek veya gizlemek için tıklayabileceği bir düğme gibi her zaman bir kullanıcı arabirimi (UI) öğesi oluşturmanız gerekir.

Şunlar için geçerlidir: Bu konudaki bilgiler Outlook için VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Bu izlenecek yol özellikle Excel'i kullansa da, izlenecek yol tarafından gösterilen kavramlar yukarıda listelenen tüm uygulamalar için geçerlidir.

Bu izlenecek yol aşağıdaki görevleri gösterir:

  • Özel görev bölmesinin kullanıcı arabirimini tasarlama.

  • Şerit'e iki durumlu düğme ekleme.

  • Geçiş düğmesini özel görev bölmesiyle eşitleme.

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 IDE'yi kişiselleştirme.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

  • Microsoft Office geliştirici araçlarını içeren bir Visual Studio sürümü. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.

  • Microsoft Excel veya Microsoft Excel 2013 .

Eklenti projesini oluşturma

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

Yeni proje oluşturmak için

  1. Excel Eklentisi proje şablonunu kullanarak SynchronizeTaskPaneAndRibbon adlı bir Excel Eklentisi 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 veya ThisAddIn.vb kod dosyasını açar ve SynchronizeTaskPaneAndRibbon projesini Çözüm Gezgini ekler.

Şeride iki durumlu düğme ekleme

Office uygulaması lication tasarım yönergelerinden biri, kullanıcıların her zaman Office uygulaması lication kullanıcı arabirimini denetlemesi gerektiğidir. Kullanıcıların özel görev bölmesini denetlemesini sağlamak için, görev bölmesini gösteren ve gizleyen bir Şerit iki durumlu düğmesi ekleyebilirsiniz. Geçiş düğmesi oluşturmak için projeye bir Şerit (Visual Tasarım Aracı) öğesi ekleyin. Tasarımcı denetimleri eklemenize ve konumlandırmanıza, denetim özelliklerini ayarlamanıza ve denetim olaylarını işlemenize yardımcı olur. Daha fazla bilgi için bkz . Şerit tasarımcısı.

Şeride iki durumlu düğme eklemek için

  1. Proje menüsünde Yeni Öğe Ekle'ye tıklayın.

  2. Yeni Öğe Ekle iletişim kutusunda Şerit (Görsel Tasarım Aracı) öğesini seçin.

  3. Yeni Şeridin adını ManageTaskPaneRibbon olarak değiştirin ve Ekle'ye tıklayın.

    ManageTaskPaneRibbon.cs veya ManageTaskPaneRibbon.vb dosyası Şerit Tasarım Aracı açılır ve varsayılan bir sekme ve grup görüntüler.

  4. Şerit Tasarım Aracı grup1'e tıklayın.

  5. Özellikler penceresinde Etiket özelliğini Görev Bölmesi Yöneticisi olarak ayarlayın.

  6. Araç Kutusu'nun Office Şerit Denetimleri sekmesinden, Görev Bölmesi Yöneticisi grubuna bir ToggleButton sürükleyin.

  7. toggleButton1'e tıklayın.

  8. Özellikler penceresinde Label özelliğini Görev Bölmesini Göster olarak ayarlayın.

Özel görev bölmesinin kullanıcı arabirimini tasarlama

Özel görev bölmeleri için görsel tasarımcı yoktur, ancak istediğiniz düzende bir kullanıcı denetimi tasarlayabilirsiniz. Bu kılavuzun ilerleyen bölümlerinde kullanıcı denetimini özel görev bölmesine ekleyebilirsiniz.

Özel görev bölmesinin kullanıcı arabirimini tasarlamak için

  1. Proje menüsünde Kullanıcı Denetimi Ekle'ye tıklayın.

  2. Yeni Öğe 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.

  3. Araç Kutusu'nun Ortak Denetimler sekmesinden textboxdenetimini kullanıcı denetimine sürükleyin.

Özel görev bölmesini oluşturma

VSTO Eklentisi başlatıldığında özel görev bölmesini oluşturmak için, kullanıcı denetimini VSTO Eklentisinin Startup olay işleyicisindeki görev bölmesine ekleyin. Varsayılan olarak, özel görev bölmesi görünmez. Bu kılavuzun ilerleyen bölümlerinde, kullanıcı şeride eklediğiniz iki durumlu düğmeyi tıklattığında görev bölmesini görüntüleyen veya gizleyen kod ekleyebilirsiniz.

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

  1. Çözüm Gezgini'de Excel'i genişletin.

  2. ThisAddIn.cs veya ThisAddIn.vb dosyasına sağ tıklayın ve Kodu Görüntüle'ye tıklayın.

  3. Aşağıdaki kodu ThisAddIn sınıfına ekleyin. Bu kod, öğesinin TaskPaneControl bir örneğini üyesi ThisAddInolarak bildirir.

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

  4. Olay işleyicisini ThisAddIn_Startup aşağıdaki kodla değiştirin. Bu kod nesneyi alana eklerTaskPaneControl, ancak özel görev bölmesini görüntülemez (varsayılan olarak sınıfın VisibleCustomTaskPane özelliği false'tur).CustomTaskPanes Visual C# kodu da olaya bir olay işleyicisi VisibleChanged ekler.

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

  5. Sınıfına aşağıdaki yöntemi ThisAddIn ekleyin. Bu yöntem olayı işler VisibleChanged . Kullanıcı Kapat düğmesine (X) tıklayarak görev bölmesini kapattığında, bu yöntem Şeritteki iki durumlu düğmenin durumunu güncelleştirir.

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

  6. Sınıfına aşağıdaki özelliği ThisAddIn ekleyin. Bu özellik, özel taskPaneValue nesneyi diğer sınıflarda kullanıma sunar. Bu kılavuzun ilerleyen bölümlerinde, bu özelliği kullanan sınıfına MyRibbon kod ekleyebilirsiniz.

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

İki durumlu düğmeyi kullanarak özel görev bölmesini gizleme ve gösterme

Son adım, kullanıcı Şeritteki iki durumlu düğmeyi tıklattığında özel görev bölmesini görüntüleyen veya gizleyen kod eklemektir.

Geçiş düğmesini kullanarak özel görev bölmesini görüntülemek ve gizlemek için

  1. Şerit Tasarım Aracı Görev Bölmesini Göster iki durumlu düğmesini çift tıklatın.

    Visual Studio, iki durumlu düğme olayını işleyen Click adlı toggleButton1_Clickbir olay işleyicisini otomatik olarak oluşturur. Visual Studio ayrıca Kod Düzenleyicisi'nde MyRibbon.cs veya MyRibbon.vb dosyasını açar.

  2. Olay işleyicisini toggleButton1_Click aşağıdaki kodla değiştirin. Kullanıcı iki durumlu düğmeyi tıklattığında, iki durumlu düğmenin basılıp basılmadığına bağlı olarak bu kod özel görev bölmesini görüntüler veya gizler.

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

Eklentiyi test edin

Projeyi çalıştırdığınızda, Excel özel görev bölmesini görüntülemeden açılır. Kodu test etmek için şeritteki iki durumlu düğmeyi tıklatın.

VSTO Eklentinizi test etmek için

  1. Projenizi çalıştırmak için F5 tuşuna basın.

    Excel'in açıldığını ve şeritte Eklentiler sekmesinin göründüğünü onaylayın.

  2. Şeritteki Eklentiler sekmesine tıklayın.

  3. Görev Bölmesi Yöneticisi grubunda Görev Bölmesini Göster iki durumlu düğmesini tıklatın.

    Geçiş düğmesine tıkladığınızda görev bölmesinin alternatif olarak görüntülendiğini ve gizlendiğini doğrulayın.

  4. Görev bölmesi görünür durumdayken, görev bölmesinin köşesindeki Kapat düğmesine (X) tıklayın.

    İki durumlu düğmenin basılmadığını doğrulayın.

Sonraki adımlar

Şu konulardan özel görev bölmeleri oluşturma hakkında daha fazla bilgi edinebilirsiniz:

  • Farklı bir uygulama için VSTO Eklentisi'nde ö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.

  • Özel görev bölmesinden bir uygulamayı otomatikleştirme. Daha fazla bilgi için bkz . İzlenecek yol: Özel görev bölmesinden bir uygulamayı otomatikleştirme.

  • Outlook'ta açılan her e-posta iletisi için özel bir görev bölmesi oluşturun. Daha fazla bilgi için bkz . İzlenecek yol: Outlook'ta e-posta iletileriyle özel görev bölmelerini görüntüleme.

İlgili içerik