İzlenecek Yol: Outlook'ta E-Posta İletileri ile Birlikte Özel Görev Bölmelerini Görüntüleme

Makale
08/01/2011

Bu anlatımda her oluşturulan veya açılan e-posta iletisi için özel görev bölmesinin farklı bir örneğinin nasıl görüntülendiği gösterilir. Kullanıcılar, her e-posta iletisinin Şerit'inde bir düğme aracılığıyla özel görev bölmesini görüntüleyebilir ya da saklayabilir.

Uygulama alanı: Bu konudaki bilgiler Outlook 2007 ve Outlook 2010 uygulamalarının uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Çoklu Explorer veya Inspector pencereleriyle birlikte özel görev bölmesini görüntülemek isterseniz her açılan pencere için özel görev bölmesinin yeni bir örneğini oluşturmalısınız. Outlook pencerelerinde özel görev bölmelerinin davranışları hakkında daha fazla bilgi için, bkz. Özel Görev Bölmelerine Genel Bakış.

Not

Bu anlatım eklenti kodunu, arkasındaki mantığı daha anlaşılır kılmak için küçük parçalar hâlinde gösterir. Bu anlatımda düzenlediğiniz herhangi bir dosyanın içeriğinin tamamını görmek için bkz. Nasıl Yapılır: Outlook'taki E-Posta İletileri ile Özel Görev Bölmelerini Görüntüleme.

Bu anlatım aşağıdaki görevleri gösterir:

Özel görev bölmesinin kullanıcı arabirimini (UI) tasarlama
Özel bir Şerit UI'ı oluşturma.
Outlook'ta e-posta iletileri ile birlikte özel Şerit UI'ını görüntüleme.
Inspector pencerelerini ve özel görev bölmelerini yönetmek için bir sınıf oluşturma.
Eklenti tarafından kullanılan kaynakları başlatma ve temizleme.
Şerit'in İki durumlu 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. Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler. Daha fazla bilgi için bkz. Ayarlar ile çalışma.

Önkoşullar

Bu yönergeyi 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 2010 sürümü. Daha fazla bilgi için bkz: [Office Çözümeri Geliştirmek İçin Bilgisayarı Yapılandırma](bb398242\(v=vs.100\).md).

Microsoft Office Outlook 2007 veya Microsoft Outlook 2010.

Mürekkepten videoya İlgili video gösterimi için, bkz. Nasıl Yaparım: Outlook'ta görev bölmeleri kullanılır?.

Projeyi Oluşturma

Özel görev bölmesi uygulama düzeyi eklentilerinde uygulanır. Outlook için bir eklenti projesi oluşturarak başlayın.

Yeni bir proje oluşturmak için

OutlookMailItemTaskPane adında bir Outlook Eklenti projesi oluşturun. Outlook Eklenti projesi şablonunu kullanın. 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 OutlookMailItemTaskPane projesini Çözüm Gezgini'ne ekler.

Özel Görev Bölmesinin Kullanıcı Arabirimini Tasarlama

Özel görev bölmeleri için görsel tasarımcı yoktur, ancak istediğiniz UI ile bir kullanıcı denetimi tasarlayabilirsiniz. Bu eklentideki özel görev bölmesinin TextBox içeren basit bir UI'ı vardır. İzlenecek bu yolun ilerleyen aşamalarında, özel görev bölmesine kullanıcı denetimi ekleyeceksiniz.

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

Çözüm Gezgini'nde OutlookMailItemTaskPane'i tıklayın.
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.

Şeritin Kullanıcı Arayüzünü Tasarlama

Bu eklentinin amaçlarından biri her e-posta iletisinin Şeritinden kullanıcılara özel görev bölmesini saklama veya görüntüleme olanağı vermektir. Kullanıcı arayüzünü yaratmak için kullanıcıların tıklayarak özel görev bölmesini görüntüleyip saklayabileceği iki durumlu bir düğme görüntüleyen özel bir Şerit UI'ı oluşturun.

Özel Şerit UI'ı oluşturmak için

Proje menüsünde, Yeni Öğe Ekle'ye 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.
De Özellikler penceresinde, Etiket ö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 denetimi sürükleyin.
toggleButton1'e tıklayın.
De Özellikler penceresinde, Etiket görev bölmesini göster özelliği.

Outlook'ta E-Posta İletileri ile Birlikte Özel Şerit UI'ı Görüntüleme

Bu anlatımda oluşturduğunuz özel görev bölmesi sadece e-posta iletileri içeren Inspector pencerelerinde gözükmek üzere tasarlanmıştır. Bu yüzden, özel Şerit UI'ınızı sadece bu pencerelerle görüntülemek için özellikleri ayarlayın.

Outlook'ta e-posta iletileri ile birlikte özel Şerit UI'ını görüntülemek için

Şerit Tasarımcı'sında ManageTaskPaneRibbon Şerit'ini tıklatın.
Properties penceresinde RibbonType özelliğinin yanındaki açılır listeyi tıklatın, Microsoft.Outlook.Mail.Compose ve Microsoft.Outlook.Mail.Read'i seçin.

Inspector Pencerelerini ve Özel Görev Bölmelerini Yönetmek için Bir Sınıf Oluşturma

Eklentinin belirli bir e-posta iletisiyle hangi görev bölmesinin ilişkili olduğunu bulduğu çeşitli durumlar vardır. Bu durumlara aşağıdakiler dahildir:

Kullanıcının bir e-posta iletisini kapattığı zaman. Bu durumda, eklenti kullandığı kaynakların düzgün bir şekilde temizlendiğinden emin olmak için ilgili özel görev bölmesini kaldırmalıdır.
Kullanıcının özel görev bölmesini kapattığı zaman. Bu durumda, eklenti e-posta iletisinin Şeritindeki iki durumlu düğmenin durumu güncellemelidir.
Kullanıcı Şeritteki iki durumlu düğmeye tıkladığında. Bu durumda, eklenti ilgili görev bölmesini saklamalı ya da görüntülemelidir.

Eklentinin hangi özel görev bölmesinin hangi açık e-posta iletisiyle ilişkili olduğunun kaydını tutması için, Inspector ve CustomTaskPane nesne çiftlerini saran özel bir sınıf oluşturun. Bu sınıf her e-posta iletisi için yeni bir özel görev bölmesi nesnesi oluşturur ve özel gmrev bölmesini ilgili e-posta iletisi kapandığında siler.

Inspector pencerelerini ve özel görev bölmelerini yönetmek üzere bir sınıf oluşturmak için

Çözüm Gezgini'nde ThisAddin.cs veya ThisAddin.vb dosyasına sağ tıklayın ve sonra Kodu Göster'i tıklayın.

Dosyanın en üstüne, aşağıdaki ifadeleri ekleyin.

Imports System.Collections.Generic
Imports Microsoft.Office.Tools
Imports Office = Microsoft.Office.Core
Imports Outlook = Microsoft.Office.Interop.Outlook

using Microsoft.Office.Tools;

Aşağıdaki kodu ThisAddIn.cs veya ThisAddIn.vb dosyasında ThisAddIn sınıfının dışına ekleyin. ((Visual C#'ta bu kodu OutlookMailItemTaskPane isim uzayının içerisine ekleyin.) InspectorWrapper sınıfı bir Inspector ve CustomTaskPane nesne çiftini yönetir. Bu sınıfın tanımlamasını aşağıdaki adımlarda tamamlayacaksınız.
```
Public Class InspectorWrapper
    Private inspector As Outlook.Inspector
    Private WithEvents inspectorEvents As Outlook.InspectorEvents_Event
    Private WithEvents taskPane As CustomTaskPane
```
```
public class InspectorWrapper
{
    private Outlook.Inspector inspector;
    private CustomTaskPane taskPane;
```

Bir önceki basamaktaki kodu ekledikten sonra, aşağıdaki kodu oluşturucuya ekleyin. Bu oluşturucu geçirilen Inspector nesnesiyle ilişkili yeni bir özel görev bölmesi oluşturup başlatır. C#'ta, oluşturucu ayrıca Inspector nesnesinin Close olayına ve CustomTaskPane nesnesinin VisibleChanged olayına işleyiciler de iliştirir.

Public Sub New(ByVal Inspector As Outlook.Inspector)
    Me.inspector = Inspector
    inspectorEvents = TryCast(Me.inspector, Outlook.InspectorEvents_Event)
    taskPane = Globals.ThisAddIn.CustomTaskPanes.Add(New TaskPaneControl(), _
        "My task pane", Inspector)
End Sub

public InspectorWrapper(Outlook.Inspector Inspector)
{
    inspector = Inspector;
    ((Outlook.InspectorEvents_Event)inspector).Close +=
        new Outlook.InspectorEvents_CloseEventHandler(InspectorWrapper_Close);

    taskPane = Globals.ThisAddIn.CustomTaskPanes.Add(
        new TaskPaneControl(), "My task pane", inspector);
    taskPane.VisibleChanged += new EventHandler(TaskPane_VisibleChanged);
}

Bir önceki basamaktaki kodu ekledikten sonra aşağıdaki yöntemi ekleyin. Bu yöntem, InspectorWrapper sınıfında bulunan CustomTaskPane nesnesinin VisibleChanged olayı için bir işleyicidir. Bu kod, kullanıcı özel görev bölmesini açtığı veya kapattığı zaman Şerit'teki iki durumlu düğmenin durumunu günceller.

Private Sub TaskPane_VisibleChanged(ByVal sender As Object, ByVal e As EventArgs) _
    Handles taskPane.VisibleChanged
    Globals.Ribbons(inspector).ManageTaskPaneRibbon.ToggleButton1.Checked = taskPane.Visible
End Sub

void TaskPane_VisibleChanged(object sender, EventArgs e)
{
    Globals.Ribbons[inspector].ManageTaskPaneRibbon.toggleButton1.Checked = 
        taskPane.Visible;
}

Bir önceki basamaktaki kodu ekledikten sonra aşağıdaki yöntemi ekleyin. Bu yöntem, geçerli e-posta iletisini içeren Inspector nesnesinin Close olayı için bir işleyicidir. Bu olay işleyicisi e-posta kapatıldığında kaynakları serbest bırakır. Bu olay işleyicisi ayrıca özel görev bölmesini CustomTaskPanes derleminden kaldırır. Bu işlem, sonraki e-posta iletisi açıldığında özel görev bölmesinin birden çok olgusu olmasını önler.

Sub InspectorWrapper_Close() Handles inspectorEvents.Close
    If Not (taskPane Is Nothing) Then
        Globals.ThisAddIn.CustomTaskPanes.Remove(taskPane)
    End If

    taskPane = Nothing
    Globals.ThisAddIn.InspectorWrappers.Remove(inspector)
    RemoveHandler inspectorEvents.Close, AddressOf InspectorWrapper_Close
    inspector = Nothing
End Sub

void InspectorWrapper_Close()
{
    if (taskPane != null)
    {
        Globals.ThisAddIn.CustomTaskPanes.Remove(taskPane);
    }

    taskPane = null;
    Globals.ThisAddIn.InspectorWrappers.Remove(inspector);
    ((Outlook.InspectorEvents_Event)inspector).Close -=
        new Outlook.InspectorEvents_CloseEventHandler(InspectorWrapper_Close);
    inspector = null;
}

Bir önceki basamaktaki kodu ekledikten sonra aşağıdaki kod ekleyin. Bu anlatımın sonraki aşamalarında, bu özelliği özel görev bölmesini görüntülemek ve saklamak için özel Şerit UI'ında bir yöntemden çağıracaksınız.

    Public ReadOnly Property CustomTaskPane() As CustomTaskPane
        Get
            Return taskPane
        End Get
    End Property
End Class

    public CustomTaskPane CustomTaskPane
    {
        get
        {
            return taskPane;
        }
    }
}

Eklenti Tarafından Kullanılan Kaynakları Başlatma ve Temizleme

Eklenti yüklendiğinde eklentiyi başlatmak ve kaldırıldığında eklentinin kullandığı kaynakları temizlemek için ThisAddIn sınıfına kod ekleyin. NewInspector olayı için bir işleyici hazırlayıp bütün mevcut e-posta iletilerini bu olay işleyicisine geçirerek eklentiyi başlatırsınız. Eklenti kaldırıldığı zaman olay işleyicisini ayırın ve eklenti tarafından kullanılan nesneleri temizleyin.

Eklenti tarafından kullanılan kaynakları başlatmak ve temizlemek için

ThisAddIn.cs veya ThisAddIn.vb kod dosyasında ThisAddIn sınıfının tanımlandığı yeri bulun.
Aşağıdaki bildirimi ThisAddIn sınıfına ekleyin:
- inspectorWrappersValue alanı eklenti tarafından yönetilen bütün Inspector ve InspectorWrapper nesnelerini içerir.
- inspectors alanı geçerli Outlook örneğinde Inspector penceresi koleksiyonuna bir başvuru içerir. Bu başvuru, atık toplayıcının sonraki adımda tanımlayacağınız NewInspector olayının işleyicisini içeren belleği boşaltmasını engeller.
```
Private inspectorWrappersValue As New Dictionary(Of Outlook.Inspector, InspectorWrapper)
Private WithEvents inspectors As Outlook.Inspectors
```
```
private Dictionary<Outlook.Inspector, InspectorWrapper> inspectorWrappersValue =
    new Dictionary<Outlook.Inspector, InspectorWrapper>();
private Outlook.Inspectors inspectors;
```

ThisAddIn_Startup yöntemini aşağıdaki kod ile değiştirin. Bu kod, NewInspector olayına bir işleyici iliştirir ve var olan bütün Inspector nesnelerini bu olay işleyicisine geçirir. Kullanıcı eklentiyi Outlook çalışmaya başladıktan sonra yüklerse eklenti bu bilgileri açık olan her e-posta iletisi için özel görev bölmeleri oluşturmak üzere kullanır.

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

    inspectors = Me.Application.Inspectors
    Dim inspector As Outlook.Inspector
    For Each inspector In inspectors
        Inspectors_NewInspector(inspector)
    Next inspector
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
        new Outlook.InspectorsEvents_NewInspectorEventHandler(
        Inspectors_NewInspector);

    foreach (Outlook.Inspector inspector in inspectors)
    {
        Inspectors_NewInspector(inspector);
    }
}

ThisAddIn_ShutDown yöntemini aşağıdaki kod ile değiştirin. Bu kod, NewInspector olay işleyicisini ayırır ve eklenti tarafından kullanılan nesneleri temizler.

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

    RemoveHandler inspectors.NewInspector, AddressOf Inspectors_NewInspector
    inspectors = Nothing
    inspectorWrappersValue = Nothing
End Sub

private void ThisAddIn_Shutdown(object sender, System.EventArgs e)
{
    inspectors.NewInspector -=
        new Outlook.InspectorsEvents_NewInspectorEventHandler(
        Inspectors_NewInspector);
    inspectors = null;
    inspectorWrappersValue = null;
}

Aşağıdaki NewInspector olay işleyicisini ThisAddIn sınıfına ekleyin. Yeni Inspector eğer bir e-posta iletisi içeriyorsa, bu yöntem e-posta iletisi ve ilgili görev bölmesi arasındaki ilişkiyi yönetmek üzere yeni bir InspectorWrapper nesnesinin olgusunu oluşturur.

Sub Inspectors_NewInspector(ByVal Inspector As Outlook.Inspector) _
    Handles inspectors.NewInspector

    If TypeOf Inspector.CurrentItem Is Outlook.MailItem Then
        inspectorWrappersValue.Add(Inspector, New InspectorWrapper(Inspector))
    End If
End Sub

void Inspectors_NewInspector(Outlook.Inspector Inspector)
{
    if (Inspector.CurrentItem is Outlook.MailItem)
    {
        inspectorWrappersValue.Add(Inspector, new InspectorWrapper(Inspector));
    }
}

Aşağıdaki özelliği ThisAddIn sınıfına ekleyin. Bu özellik private (özel) inspectorWrappersValue alanını ThisAddIn sınıfının dışında da kullanımına sunar.

Public ReadOnly Property InspectorWrappers() As Dictionary(Of Outlook.Inspector, InspectorWrapper)
    Get
        Return inspectorWrappersValue
    End Get
End Property

public Dictionary<Outlook.Inspector, InspectorWrapper> InspectorWrappers
{
    get
    {
        return inspectorWrappersValue;
    }
}

Kontrol Noktası

Hatasız derlendiğinden ve çalıştığından emin olmak için projenizi derleyin.

Projenizi yapılandırmak için

Çözüm Gezgini'nde, OutlookMailItemTaskPane projesine sağ tıklayın ve sonra Derle'ye tıklayın. Projenin hatasız derlendiğini doğrulayın.

Şerit'in İki Durumlu Düğmesini Özel Görev Bölmesiyle Eşitleme

İki durumlu düğme, görev bölmesi görünür olduğunda basılı, görev bölmesi saklı olduğunda basılmamış görünecektir. Düğme ile özel görev bölmesinin durumunu eşitlemek için düğmenin Click olay işleyicisini değiştirin.

İki durumlu düğmeyi özel görev bölmesiyle eşitlemek 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 ManageTaskPaneRibbon.cs ya da ManageTaskPaneRibbon.vb dosyasını açar.

Aşağıdaki ifadeleri ManageTaskPaneRibbon.cs veya ManageTaskPaneRibbon.vb dosyasının en üstüne ekleyin.

Imports Microsoft.Office.Tools.Ribbon
Imports Outlook = Microsoft.Office.Interop.Outlook
Imports Microsoft.Office.Tools

using Outlook = Microsoft.Office.Interop.Outlook;
using Microsoft.Office.Tools;

toggleButton1_Click olay işleyicisini aşağıdaki kod ile değiştirin. Kullanıcı iki durumlu düğmeye tıkladığında, bu yöntem geçerli Inspector penceresiyle ilişkili ö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

    Dim inspector As Outlook.Inspector = e.Control.Context
    Dim inspectorWrapper As InspectorWrapper = Globals.ThisAddIn.InspectorWrappers(inspector)
    Dim taskPane As CustomTaskPane = inspectorWrapper.CustomTaskPane
    If Not (taskPane Is Nothing) Then
        taskPane.Visible = TryCast(sender, RibbonToggleButton).Checked
    End If
End Sub

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    Outlook.Inspector inspector = (Outlook.Inspector)e.Control.Context;
    InspectorWrapper inspectorWrapper = Globals.ThisAddIn.InspectorWrappers[inspector];
    CustomTaskPane taskPane = inspectorWrapper.CustomTaskPane;
    if (taskPane != null)
    {
        taskPane.Visible = ((RibbonToggleButton)sender).Checked;
    }
}

Projeyi Sınama

Projede hata ayıklamaya başladığınızda Outlook açılır ve eklenti yüklenir. Eklenti açık olan her e-posta iletisi ile farklı bir eylem görev bölmesi örneğini gösterir. Kodu sınamak için birkaç yeni e-posta iletisi oluşturun.

Eklentiyi test etmek için

F5'e basın.
Outlook'ta yeni bir posta iletisi oluşturmak üzere Yeni'ye tıklatın.
E-posta iletisinin Şeritinde Eklentiler sekmesini ve ardından Show Task Pane (Görev Bölmesini Göster) düğmesini tıklatın.

E-posta iletisiyle birlikte My task pane başlıklı bir görev bölmesinin görüntülendiğini doğrulayın.
Görev bölmesinde metin kutusuna Birinci görev bölmesi yazın.
Görev bölmesini kapatın.

Show Task Pane düğmesinin durumunun basılı olmayacak şekilde değiştiğini doğrulayın.
Show Task Pane düğmesini tekrar tıklatın.

Görev bölmesinin açıldığını ve metin kutusunda hâlâ Birinci görev bölmesi yazdığını doğrulayın.
Outlook'ta ikinci bir posta iletisi oluşturmak üzere Yeni'ye tıklatın.
E-posta iletisinin Şeritinde Eklentiler sekmesini ve ardından Görev Bölmesini Göster düğmesini tıklatın.

E-posta iletisiyle birlikte My task pane başlıklı bir görev bölmesinin görüntülendiğini ve görev bölmesindeki metin kutusunun boş olduğunu doğrulayın.
Görev bölmesinde metin kutusuna İkinci görev bölmesi yazın.
İlk e-posta iletisinin odağını değiştirin.

Bu e-posta iletisiyle ilişkili görev bölmesinin metin kutusunda hâlâ Birinci görev bölmesi yazdığını doğrulayın.

Bu eklenti deneyebileceğiniz daha gelişmiş senaryoların da üstesinden gelir. Örneğin, Next Item (Sonraki Öğe) ve Previous Item (Önceki Öğe) düğmelerini kullanarak e-postaları görüntülerken eklentinin davranışını sınayabilirsiniz. Eklentiyi kaldırıp birkaç e-posta iletisi açıp ardından eklentiyi tekrar yükleyip davranışı sınayabilirsiniz.

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ölmelerine Genel Bakış
Microsoft Office uygulamasını özel görev bölmesi kullanarak otomatikleştirme Daha fazla bilgi için bkz. İzlenecek Yol: Uygulamayı Özel Görev Bölmesinden Otomatikleştirme.
Excel'de özel görev bölmesini saklamak veya görüntülemek için kullanabileceğiniz Şerit düğmesi oluşturma Daha fazla bilgi için bkz. İzlenecek Yol: Özel Görev Bölmesini Şerit Düğmesi ile Eşitleme.

Ayrıca bkz.

Aracılığıyla paylaş