Erstellen von Outlook-Formularbereichen

Artikel
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office. Projekttyp Projekte auf Anwendungsebene Microsoft Office-Version Outlook 2007 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office.

Projekttyp

Projekte auf Anwendungsebene

Microsoft Office-Version

Outlook 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Mithilfe dieser Microsoft Office Outlook-Formulare können Formularbereiche angepasst werden. Visual Studio Tools for Office verfügt über erweiterte Tools, die das Entwerfen, Entwickeln und Debuggen von Formularbereichen vereinfachen.

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 Visual Studio Tools for Office-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	Beschreibung
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 Tools for Office 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.

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 Visual Studio Tools for Office-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. Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Ereignishandlern im Visual Basic-Code-Editor.

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.

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 in Visual Studio Tools for Office 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	Beschreibung
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 Tools for Office der Registrierung die folgenden zusätzlichen Informationen hinzu:

Ein Schlüssel für jede Nachrichtenklasse, die mindestens einem Formularbereich 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 Tools for Office 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 von Office-Projektmappen (2007 System).