Registerkarte zum Outlook Optionen-Dialog hinzufügen

Denis — Wed, 09 Apr 2008 22:02:41 +0000

Nachdem ich jetzt ca. 1 Std. gebraucht habe um herauszufinden wie es geht beschreibe ich das einfache Verfahren.

Zunächst fügt man seinem Outlook Add-In Projekt ein Benutzersteuerelement hinzu welches die Registerkarte die man später im Optionen-Dialog haben möchte darstellt. Ich habe dieses in diesem Beispiel ctlOptionen genannt. Wichtig ist, dass man die erste Zeile (” … ComVisible(true)”) hinzufügt, da das Steuerelement ansonsten nicht als ActiveX COM Element sichtbar ist. (Dies war übrigens auch mein großes Problem, aber da muss man erst einmal ohne Fehlermeldung drauf kommen… Hier habe ich endlich die Lösung gefunden.)

Ausserdem habe ich hier eine Methode gefunden um das PropertyPageSite Objekt zu bekommen welches man braucht um das Optionen Formular durch aufrufen des OnStatusChange Ereignisses darüber zu benachrichtigen, dass sich etwas in den Optionen geändert hat. Es sollte beachtet werden, dass in diesem Beispiel beim Ändern von Einstellungen die isDirty-Variable über die entsprechende Eigenschaft auf true gesetzt werden muss, damit das Optionen-Formular benachrichtigt wird.

[System.Runtime.InteropServices.ComVisible(true)]
public partial class ctlOptionen : UserControl,
    Microsoft.Office.Interop.Outlook.PropertyPage
{
    private bool isDirty = false;
    private Microsoft.Office.Interop.Outlook.PropertyPageSite site;

    public ctlOptionen()
    {
        InitializeComponent();
    }

    #region PropertyPageSite Objekt holen
    /// 
    /// Hier wird die entpsrechende PropertyPageSite geholt, bei der das OnStatusChange()
    /// Ereignis ausgelöst wird um das Optionen-Formular zu benachrichtigen, dass etwas
    /// geändert wurde.
    /// 
    /// 
    /// 
    private void ctlOptionen_Load(object sender, EventArgs e)
    {
        Type type = typeof(UserControl);
        Type oleType = type.Assembly.GetType(
            "System.Windows.Forms.UnsafeNativeMethods+IOleObject");
        if (oleType == null) throw new InvalidOperationException(
            "Could not get 'System.Windows.Forms.UnsafeNativeMethods+IOleObject'.");

        System.Reflection.MethodInfo method =
            oleType.GetMethod("GetClientSite");
        if (method == null) throw new InvalidOperationException(
            "Could not get method 'IOleObject.GetClientSite'.");

        site = method.Invoke(this, null) as
            Microsoft.Office.Interop.Outlook.PropertyPageSite;
    }
    #endregion

    #region PropertyPage Member

    /// 
    /// Wird aufgerufen wenn die gemachten Änderungen gespeichert werden sollen 
    /// (Klick auf OK bzw. Übernehmen)
    /// 
    public void Apply()
    {
    }
    /// 
    /// Gibt true zurück, wenn die Optionen der Seite sich geändert haben. 
    /// Wird von Outlook benutzt um zu entscheiden ob der Übernehmen-Button aktiviert ist.
    /// Beim setzen wird hier das Optionen-Formular benachrichtigt, dass sich etwas 
    /// geändert hat.
    /// 
    [Browsable(false)]
    public bool Dirty
    {
        get { return isDirty; }
        set
        {
            if (isDirty != value)
            {
                isDirty = value;
                if (site != null) site.OnStatusChange();
            }
        }
    }

    /// 
    /// Hier kann man eine Hilfedatei angeben die mit dieser Seite verknüpft ist.
    /// 
    /// 
    /// 
    public void GetPageInfo(ref string HelpFile, ref int HelpContext)
    {
    }

    #endregion
}

Als nächstes fügt man einen Ereignishandler (Das ist tatsächlich die deutsche Übersetzung laut MSDN…) für das OptionPagesAdd-Event hinzu. Dieses Ereignis wird jedes mal angestoßen wenn der Optionen-Dialog geöffnet wird. Dieser kann gut in der ThisAddIn_Startup Methode der ThisAddIn-Klasse untergebracht werden.

Application.OptionsPagesAdd += new Microsoft.Office.Interop.Outlook
    .ApplicationEvents_11_OptionsPagesAddEventHandler
        (Application_OptionsPagesAdd);

Dementsprechend wird auch die Methode erstellt welche dann nichts anderes tut als die Registerkarte hinzuzufügen.

void Application_OptionsPagesAdd
    (Microsoft.Office.Interop.Outlook.PropertyPages Pages)
{
    Pages.Add(new ctlOptionen(), "Meine Optionen");
}

oliana.de » Outlook

Registerkarte zum Outlook Optionen-Dialog hinzufügen