Erstellen von Outlook-Formularbereichen

Sie können Microsoft Office Outlook-Formulare mithilfe von Formularbereichen anpassen.Visual Studio stellt erweiterte Tools bereit, die das Entwerfen, Entwickeln und Debuggen von Formularbereichen erleichtern.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für Outlook 2013 und Outlook 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Dieses Thema enthält folgende Informationen:

• Vorteile der Verwendung von Formularbereichen

• Hinzufügen eines Outlook-Formularbereichs zum Projekt

• Verwenden des Formularbereich-Designers

• Verwenden eines in Outlook entworfenen Formularbereichs

• Hinzufügen von benutzerdefiniertem Code zu einem Formularbereich

• Erstellen des Projekts

• Debuggen eines Formularbereichs

• Bereitstellen eines Formularbereichs

Vorteile der Verwendung von Formularbereichen

Formularbereiche bieten zahlreiche Verbesserungen gegenüber der traditionellen Outlook-Formularentwicklung:

• Passen Sie die Standardseite eines beliebigen Standardformulars an.

• Fügen Sie einem beliebigen Standardformular bis zu 12 zusätzliche Seiten hinzu.

• Ersetzen oder verbessern Sie jedes gewünschte Standardformular.

• Zeigen Sie eine benutzerdefinierte Benutzeroberfläche im Lesebereich und in den Inspektoren an.

Weitere Informationen finden Sie unter Customizing Form Pages and Form Regions.

Hinzufügen eines Outlook-Formularbereichs zum Projekt

Mit dem Assistenten Neuer Outlook-Formularbereich wird ein neuer Formularbereich entworfen oder ein in Outlook entworfener Formularbereich importiert.Auch ein bereits in einem anderen Outlook-Add-In-Projekt erstellter Formularbereich kann wieder verwendet werden.

Erstellen eines neuen Formularbereichs mithilfe des Assistenten

Fügen Sie zum Erstellen eines Formularbereichs einem Outlook-Add-In-Projekt ein Element von Outlook-Formularbereich hinzu.Dadurch wird der Assistent Neuer Outlook-Formularbereich gestartet.

Geben Sie mithilfe des Assistenten an, ob Sie einen neuen Formularbereich entwerfen oder einen in Outlook entworfenen Formularbereich importieren möchten.Weitere Informationen zum Entwerfen eines neuen Formularbereichs finden Sie unter Verwenden des Formularbereich-Designers.Weitere Informationen zur Verwendung eines in Outlook entworfenen Formularbereichs finden Sie unter Importieren eines in Outlook entworfenen Formularbereichs.

Geben Sie mit dem Assistenten den Typ des zu erstellenden Formularbereichs an.In der folgenden Tabelle wird jeder Formularbereichstyp beschrieben.

Bereichstyp	Description
Separat	Fügt den Formularbereich als neue Seite in einem Outlook-Formular hinzu.
Benachbart	Hängt den Formularbereich an den unteren Bereich der Standardseite eines Outlook-Formulars an.
Ersetzung	Fügt den Formularbereich als neue Seite hinzu, durch die die Standardseite eines Outlook-Formulars ersetzt wird.
Alle ersetzen	Ersetzt das gesamte Outlook-Formular durch den neuen Formularbereich.

Sie können auch den Assistenten verwenden, um Bedingungen anzuzeigen und den Typ des zu erweiternden Formulars auszuwählen.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt.

Die im Assistenten getroffene Auswahl wirkt sich auf die auf anderen Seiten des Assistenten verfügbaren Optionen aus.Bei Auswahl von Benachbart oder Separat auf der Seite Neuen Outlook-Formularbereich erstellen sind die Felder Titel und Beschreibung auf der Seite Geben Sie eine Beschreibung ein, und wählen Sie die Anzeigeeinstellungen aus beispielsweise nicht verfügbar.Dies liegt daran, dass Outlook diese Felder beim Anzeigen eines benachbarten oder gesonderten Formularbereichs nicht verwendet.

Formularbereichsdateien

Bei Fertigstellung des Assistenten Neuer Outlook-Formularbereich fügt Visual Studio dem Projekt automatisch die folgenden Dateien hinzu:

• Eine Formularbereich-Codedatei.Diese Datei besitzt den Namen, den Sie im Dialogfeld Neues Element hinzufügen für das Element Outlook-Formularbereich angeben.Fügen Sie dieser Datei zum Behandeln der Formularbereichsereignisse Code hinzu.

• Eine Codedatei für den Formularbereich-Designer.Diese Datei beinhaltet vom Formularbereich-Designer generierten Code und sollte nicht direkt bearbeitet werden.

• Eine OFS (Outlook Form Storage)-Datei.

  Hinweis
  Diese Datei wird dem Projekt nur hinzugefügt, wenn ein in Outlook entworfener Formularbereich importiert wird.

Formularbereich-Factoryklasse

Die Formularbereich-Codedatei beinhaltet eine partielle Klasse, mit der die IFormRegionFactory-Schnittstelle implementiert wird.Dabei handelt es sich um die Formularbereich-Factoryklasse.Die Formularbereich-Factoryklasse wird für das Erstellen neuer Instanzen des Formularbereichs verwendet.

Diese Klasse wird durch Erweitern des Bereichs Formularbereichsfactory angezeigt.

Mit dem Assistenten Neuer Outlook-Formularbereich werden dieser Klasse Attribute hinzugefügt, die den internen Namen des Formularbereichs und die Nachrichtenklassen zum Anzeigen des Formularbereichs angeben.Diese Attribute können nach dem Hinzufügen der Datei zum Projekt manuell geändert werden.

Der Großteil der Formularbereich-Factoryklasse wird in der Formularbereich-Designerdatei implementiert.Allerdings wird der FormRegionInitializing-Ereignishandler in der Formularbereich-Codedatei verfügbar gemacht.Geben Sie mit diesem Ereignishandler an, ob Outlook den Formularbereich anzeigen soll.Weitere Informationen finden Sie unter Behandeln von Formularbereichsereignissen.

Hinzufügen eines vorhandenen Formularbereichs zum Projekt

Verfügen Sie über einen Outlook-Formularbereich, den Sie in einem anderen Outlook-Projekt verwendet haben, kann dieser im aktuellen Outlook-Add-In-Projekt mithilfe des Dialogfelds Vorhandenes Element hinzufügen wieder verwendet werden.

Der vorhandene Formularbereich muss eine Codedatei beinhalten (VB- oder CS-Datei); OFS (Outlook Form Storage)-Dateien können im Dialogfeld Vorhandenes Element hinzufügen nicht hinzugefügt werden.Allerdings kann ein neuer Formularbereich durch Importieren einer Outlook Form Storage-Datei erstellt werden.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt.

Verwenden des Formularbereich-Designers

Der Formularbereich-Designer unterstützt Sie beim Entwerfen des Layouts und der Darstellung eines Formularbereichs.Verwaltete Steuerelemente können auf die Oberfläche des Designers gezogen werden; doppelklicken Sie zum Öffnen von Ereignishandlern auf Steuerelemente, und legen Sie Eigenschaften im Fenster Eigenschaften fest.

Hinweis
Eigenschaften, die die Darstellung des Formularbereichs in Outlook beeinflussen, finden Sie unter dem Knoten Manifest im Fenster Eigenschaften.

Der Formularbereich-Designer ist nur verfügbar, wenn im Assistenten Neuer Outlook-Formularbereich auf der Seite Legen Sie fest, wie der Formularbereich erstellt werden soll die Option Neuen Formularbereich entwerfen ausgewählt wird.

Zum Öffnen des Formularbereich-Designers stehen drei Möglichkeiten zur Verfügung:

• Doppelklicken Sie im Projektmappen-Explorer auf die Formularbereich-Codedatei.

• Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Formularbereich-Codedatei, und klicken Sie danach auf Code anzeigen.

• Wählen Sie im Projektmappen-Explorer die Formularbereich-Codedatei aus, und klicken Sie dann im Menü Ansicht auf Designer.

Vom Formularbereich-Designer werden nur verwaltete Steuerelemente unterstützt.Systemeigene Outlook-Steuerelemente können nicht hinzugefügt werden.

Importieren eines in Outlook entworfenen Formularbereichs

Bei Entwürfen in Outlook können dem Formularbereich systemeigene Outlook-Steuerelemente hinzugefügt werden.Systemeigene Outlook-Steuerelemente ermöglichen das Binden an Outlook-Daten während der Entwurfszeit.Allerdings ist es anschließend nicht möglich, mit dem Formularbereich-Designer verwaltete Steuerelemente hinzuzufügen oder den Entwurf des Formularbereichs zu ändern.

Sie können Formularbereiche mithilfe des Assistenten Neuer Outlook-Formularbereich in ein Outlook-Add-In-Projekt importieren.Wählen Sie auf der Seite Legen Sie fest, wie der Formularbereich erstellt werden soll die Option OFS-Datei (Outlook Form Storage) importieren.Anschließend können Sie zum Speicherort einer OFS (Outlook Form Storage)-Datei navigieren.(Outlook speichert Formularbereiche als OFS-Dateien.)

Mit dem Assistenten Neuer Outlook-Formularbereich wird die OFS-Datei in das Projektverzeichnis kopiert, und der Formularbereich-Designerdatei werden Steuerelementverweise hinzugefügt.Anschließend können Steuerelementereignisse in der Formularbereich-Codedatei behandelt werden.

Wählen Sie zum Behandeln von Ereignissen in einem Visual Basic-Projekt ein Ereignis aus der Methodennamenliste am Anfang des Code-Editors.

Sollen Ereignisse in einem C#-Projekt behandelt werden, abonnieren Sie die Steuerelementereignisse in der FormRegionShowing-Methode.Weitere Informationen finden Sie unter Gewusst wie: Abonnieren von Ereignissen und Kündigen von Ereignisabonnements (C#-Programmierhandbuch).

Formularbereichseigenschaften können in der InitializeManifest-Methode der Formularbereich-Factoryklasse geändert werden.

Hinweis
Zum Importieren eines Formularbereichs müssen Sie in einem Projekt arbeiten, das auf dieselbe Version von Outlook abzielt, die Sie auf dem Entwicklungscomputer installiert haben.Wenn Sie z. B. Outlook 2010 installiert haben, funktioniert das Importieren eines Formularbereichs nur in einem Projekt, das mit der Projektvorlage Outlook 2010-Add-In erstellt wurde.

Aktualisieren des Entwurfs eines importierten Formularbereichs

Steuerelemente für den Formularbereich können hinzugefügt, entfernt oder geändert werden.Erstellen Sie zuvor eine Sicherungskopie von jedem Code, den Sie der Formularbereich-Codedatei hinzugefügt haben.Öffnen Sie anschließend in Outlook die OFS-Datei, ändern Sie den Formularbereich, und speichern Sie anschließend die Änderungen.Importieren Sie die geänderte OFS-Datei mithilfe des Assistenten Neuer Outlook-Formularbereich.Anschließend kann der Code in die neue Formularbereich-Codedatei eingefügt werden.

Hinzufügen von benutzerdefiniertem Code zu einem Formularbereich

Über den Microsoft.Office.Tools.Outlook-Namespace erhalten Sie Zugriff auf Klassen, die den Formularbereich darstellen, das Outlook-Element, das den Formularbereich anzeigt, sowie auf andere nützliche Elemente.Mit dem Element Outlook-Formularbereich wird dieser Assembly im Projekt automatisch ein Verweis hinzugefügt, und die entsprechende using-Anweisung oder Imports-Anweisung wird am Anfang der Formularbereich-Codedatei eingefügt.

Mit Klassen, Methoden und Eigenschaften im Microsoft.Office.Interop.Outlook-Namespace können die meisten Outlook-Programmieraufgaben durchgeführt werden.Weitere Informationen zum Outlook-Objektmodell finden Sie unter Übersicht über das Outlook-Objektmodell.Beispiele häufiger Aufgaben, für die das Outlook-Objektmodell verwendet wird, finden Sie unter Outlook-Projektmappen.

Behandeln von Formularbereichsereignissen

Mit dem Element Outlook-Formularbereich werden der Formularbereich-Codedatei automatisch die folgenden drei Ereignishandler hinzugefügt.

Ereignis	Description
FormRegionInitializing	Tritt ein, bevor der Formularbereich initialisiert wird.Bedingungen in diesem Ereignishandler können überprüft werden, um zu bestimmen, ob Outlook den Formularbereich anzeigen soll.Weitere Informationen finden Sie unter Gewusst wie: Verhindern der Anzeige eines Formularbereichs in Outlook.
FormRegionShowing	Tritt nach dem Erstellen einer Instanz des Formularbereichs, jedoch vor dem Anzeigen des Formularbereichs ein.
FormRegionClosed	Tritt ein, bevor der Formularbereich geschlossen wird.

Erstellen des Projekts

Wenn Sie ein Outlook-Add-In-Projekt erstellen, das einen Formularbereich enthält, fügt Visual Studio der Registrierung die folgenden zusätzlichen Informationen hinzu:

• Ein Schlüssel für jede Nachrichtenklasse, die einem oder mehreren Formularbereichen zugeordnet ist.

• Ein Eintrag für jeden Formularbereich und ein zugeordneter Wert, der den Namen des Outlook-Add-Ins darstellt.

Outlook verwendet diese Informationen zum Laden der Formularbereiche.

Debuggen eines Formularbereichs

Sie können ein Outlook-Add-In, das einen Formularbereich beinhaltet, ebenso wie andere Visual Studio-Projekte debuggen.Beim Start des Visual Studio-Debuggers wird Outlook automatisch von Visual Studio gestartet.

Zum Anzeigen des Formularbereichs muss das entsprechende Outlook-Element geöffnet werden.Wird beispielsweise an den unteren Bereich eines E-Mail-Elements ein benachbarter Formularbereich angehängt, muss ein E-Mail-Element geöffnet werden.

Bereitstellen eines Formularbereichs

Formularbereiche werden automatisch mit dem zugeordneten Outlook-Add-In bereitgestellt.Daher müssen zur Bereitstellung eines Formularbereichs keine besonderen Aufgaben ausgeführt werden.Weitere Informationen zum Bereitstellen von Add-Ins finden Sie unter Bereitstellen einer Office-Projektmappe.

Verwandte Themen

Titel	Description
Richtlinien zum Erstellen von Outlook-Formularbereichen	Hier finden Sie Informationen, mit deren Hilfe Sie die Formularbereiche optimieren und mögliche Probleme vermeiden können.
Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt	Hier wird gezeigt, wie Sie mithilfe des Assistenten Neuer Outlook-Formularbereich einen Formularbereich erstellen, um ein standardmäßiges oder benutzerdefiniertes Microsoft Office Outlook-Formular zu erweitern.
Zuordnen eines Formularbereichs zu einer Outlook-Nachrichtenklasse	Hier wird erläutert, wie Sie die Microsoft Office Outlook-Elemente angeben, für die ein Formularbereich angezeigt wird, indem Sie den Formularbereich der Nachrichtenklasse jedes Elements zuordnen.
Exemplarische Vorgehensweise: Entwerfen eines Outlook-Formularbereichs	Hier wird gezeigt, wie ein benutzerdefinierter Formularbereich entworfen wird, der als neue Seite im Inspektor-Fenster eines Kontaktelements angezeigt wird.
Exemplarische Vorgehensweise: Importieren eines in Outlook entworfenen Formularbereichs	Hier wird gezeigt, wie in Microsoft Office Outlook ein Formularbereich entworfen und anschließend mithilfe des Assistenten Neuer Outlook-Formularbereich in ein Outlook-Add-In-Projekt importiert wird.
Zugreifen auf einen Formularbereich zur Laufzeit	Hier wird beschrieben, wie Sie Code zum Anzeigen, Ausblenden oder Ändern von Steuerelementen in einem Formularbereich schreiben und Benutzern mithilfe der Globals-Klasse das Ausführen des Codes in anderen Bereichen des Projekts ermöglichen.
Gewusst wie: Verhindern der Anzeige eines Formularbereichs in Outlook	Hier wird beschrieben, wie die Anzeige eines Formularbereichs für ein bestimmtes Element in Microsoft Office Outlook verhindert werden kann.
Hier wird gezeigt, wie Sie auf das Outlook-Element zugreifen, in dem ein Formularbereich angezeigt wird.
Benutzerdefinierte Aktionen in Outlook-Formularbereichen	Hier wird beschrieben, wie Sie Benutzern das Reagieren auf ein Outlook-Element ermöglichen.