Erstellen von Outlook-Formularbereichen

Sie können Formularbereiche verwenden, um Microsoft Office Outlook-Formulare anzupassen. Visual Studio bietet erweiterte Tools, mit denen Sie Formularbereiche entwerfen, entwickeln und debuggen können.

Gilt für: Die Informationen in diesem Thema gelten für VSTO-Add-In-Projekte für Outlook. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.

Dieses Thema enthält die folgenden Informationen:

• Vorteile der Verwendung von Formularbereichen

• Hinzufügen eines Outlook-Formularbereichs zu Ihrem 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 entwicklung von herkömmlichen Outlook-Formularen:

• Passen Sie die Standardseite eines beliebigen Standardformulars an.

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

• Ersetzen oder verbessern Sie alle Standardformulare.

• Benutzerdefinierte Benutzeroberfläche im Lesebereich und in Inspektoren anzeigen.

  Weitere Informationen finden Sie unter Anpassen von Formularseiten und Formularbereichen.

Hinzufügen eines Outlook-Formularbereichs zu Ihrem Projekt

Sie können den Assistenten " Neuer Outlook-Formularbereich " verwenden, um einen neuen Formularbereich zu entwerfen oder einen Formularbereich zu importieren, der in Outlook entworfen wurde. Wenn Sie auch einen Formularbereich haben, den Sie in einem anderen Outlook VSTO-Add-In-Projekt verwendet haben, können Sie den vorhandenen Formularbereich wiederverwenden.

Erstellen eines neuen Formularbereichs mithilfe des Assistenten

Zum Erstellen eines Formularbereichs fügen Sie einem Outlook-VSTO-Add-In-Projekt ein Outlook-Formularbereichelement hinzu. Dadurch wird der Assistent " Neuer Outlook-Formularbereich " gestartet.

Verwenden Sie den Assistenten, um anzugeben, ob Sie einen neuen Formularbereich entwerfen oder einen Formularbereich importieren möchten, der in Outlook entworfen wurde. 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.

Verwenden Sie den Assistenten, um den Typ des Formularbereichs anzugeben, den Sie erstellen möchten. In der folgenden Tabelle werden die einzelnen Formularbereichstypen beschrieben.

Sie können den Assistenten auch verwenden, um Anzeigebedingungen anzugeben und den zu erweiternden Formulartyp auszuwählen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen eines Formularbereichs zu einem Outlook-Add-In-Projekt.

Die Auswahl, die Sie im Assistenten vornehmen, wirkt sich auf die Optionen aus, die auf anderen Assistentenseiten zur Verfügung stehen. Wenn Sie zum Beispiel auf der Seite "Neuen Outlook-Formularbereich erstellen" Angrenzend oder Getrennt auswählen, sind die Felder Titel und Beschreibung auf der Seite Beschreibenden Text angeben und Anzeigeeinstellungen auswählen nicht verfügbar. Dies liegt daran, dass Outlook diese Felder nicht verwendet, wenn ein angrenzender oder separater Formularbereich angezeigt wird.

Formularbereichsdateien

Wenn Sie den Assistenten für den neuen Outlook-Formularbereich abschließen, fügt Visual Studio Ihrem Projekt automatisch die folgenden Dateien hinzu:

• Eine Formularbereichscodedatei. Diese Datei hat den Namen, den Sie für das Outlook-Formularbereich-Element im Dialogfeld " Neues Element hinzufügen " angeben. Fügen Sie dieser Datei Code zum Behandeln von Formularbereich-Ereignisse hinzu.

• Codedatei des Formularbereichsentwicklers. Diese Datei enthält Code, der vom Formularbereich-Designer generiert wird und nicht direkt bearbeitet werden sollte.

• Eine Outlook-Formularspeicherdatei (OFS).

  Hinweis

  Diese Datei wird nur dem Projekt hinzugefügt, wenn Sie einen Formularbereich importieren, der in Outlook entworfen wurde.

Formularbereich-Factoryklasse

Die Codedatei des Formularbereichs enthält eine partielle Klasse, die die IFormRegionFactory Schnittstelle implementiert. Dies ist die Formularbereich-Factoryklasse. Die Factory-Klasse des Formularbereichs ist für das Erstellen neuer Instanzen des Formularbereichs verantwortlich.

Sie finden diese Klasse, indem Sie die Form Region Factory erweitern.

Der Assistent " Neuer Outlook-Formularbereich " fügt dieser Klasse Attribute hinzu, die den internen Namen des Formularbereichs und die Nachrichtenklassen angeben, die den Formularbereich anzeigen. Sie können diese Attribute manuell ändern, nachdem die Datei dem Projekt hinzugefügt wurde.

Der Großteil der Formularbereich-Factoryklasse wird in der Formularbereich-Designerdatei implementiert. Der FormRegionInitializing Ereignishandler wird jedoch in der Codedatei des Formularbereichs verfügbar gemacht. Mit diesem Ereignishandler können Sie angeben, ob Outlook den Formularbereich anzeigen soll. Weitere Informationen finden Sie unter Verwalten von Ereignissen im Formularbereich.

Hinzufügen eines vorhandenen Formularbereichs zu Ihrem Projekt

Wenn Sie einen Outlook-Formularbereich haben, den Sie in einem anderen Outlook-Projekt verwendet haben, können Sie ihn in Ihrem aktuellen Outlook-VSTO-Add-In-Projekt wiederverwenden, indem Sie das Dialogfeld " Vorhandenes Element hinzufügen " verwenden.

Der vorhandene Formularbereich muss über eine Codedatei (.vb oder .cs) verfügen. Sie können keine Outlook-Formularspeicherdateien (OFS)-Dateien hinzufügen, indem Sie das Dialogfeld " Vorhandenes Element hinzufügen " verwenden. Sie können jedoch einen neuen Formularbereich erstellen, indem Sie eine Outlook-Formularspeicherdatei importieren. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen eines Formularbereichs zu einem Outlook-Add-In-Projekt.

Den Formularbereich-Designer verwenden

Der Formularbereich-Designer hilft Ihnen beim Entwerfen des Layouts und der Darstellung eines Formularbereichs. Sie können verwaltete Steuerelemente auf die Oberfläche des Designers ziehen, auf Steuerelemente doppelklicken, um Ereignishandler zu öffnen und Eigenschaften im Eigenschaftenfenster festzulegen.

Der Formularbereich-Designer ist nur verfügbar, wenn Sie im Assistenten für Neuen Outlook-Formularbereich auf der Seite Wählen Sie aus, wie Sie den Formularbereich erstellen möchten die Option Formularbereich entwerfen auswählen.

Es gibt drei Möglichkeiten zum Öffnen des Formularbereich-Designers:

• Doppelklicken Sie im Projektmappen-Explorer auf die Codedatei des Formularbereichs.

• Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei des Formularbereichs, und klicken Sie dann auf "Designer anzeigen".

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

  Der Formularbereich-Designer unterstützt nur verwaltete Steuerelemente. Sie können keine nativen Outlook-Steuerelemente hinzufügen.

Importieren eines in Outlook entworfenen Formularbereichs

Wenn Sie in Outlook entwerfen, können Sie dem Formularbereich systemeigene Outlook-Steuerelemente hinzufügen. Mit nativen Outlook-Steuerelementen können Sie zur Entwurfszeit Outlook-Daten verknüpfen. Sie können dann jedoch nicht den Formularbereich-Designer verwenden, um verwaltete Steuerelemente hinzuzufügen oder den Entwurf des Formularbereichs zu ändern.

Sie können Formularbereiche in ein Outlook VSTO-Add-In-Projekt importieren, indem Sie den Assistenten für den neuen Outlook-Formularbereich verwenden. Wählen Sie auf der Seite "Wie möchten Sie den Formularbereich erstellen?" die Option "Eine Outlook-Formularspeicherdatei (.ofs) importieren" aus. Sie können dann zum Speicherort einer Outlook-Formularspeicherdatei (OFS) navigieren. (Outlook speichert Formularbereiche als OFS-Dateien .)

Der Assistent für den neuen Outlook-Formularbereich kopiert die OFS-Datei in das Projektverzeichnis und fügt Steuerelementverweise zur Formularbereich-Designerdatei hinzu. Anschließend können Sie Steuerelementereignisse in der Codedatei des Formularbereichs behandeln.

Um Ereignisse in einem Visual Basic-Projekt zu behandeln, wählen Sie oben im Code-Editor ein Ereignis aus der Methodennamenliste aus.

Um Ereignisse in einem C#-Projekt zu behandeln, abonnieren Sie Steuerelementereignisse in der FormRegionShowing Methode. Weitere Informationen finden Sie unter Wie man: Ereignisse abonniert und abbestellt (C#-Programmierhandbuch).

Sie können formularbereichseigenschaften in der InitializeManifest Methode der Formularbereich-Factoryklasse ändern.

Aktualisieren des Entwurfs eines importierten Formularbereichs

Sie können Steuerelemente im Formularbereich hinzufügen, entfernen oder ändern. Sichern Sie zuvor den Code, den Sie der Formularbereichs-Codedatei hinzugefügt haben. Öffnen Sie dann die OFS-Datei in Outlook, ändern Sie den Formularbereich, und speichern Sie dann die Änderungen. Verwenden Sie den Assistenten für den neuen Outlook-Formularbereich , um die geänderte OFS-Datei zu importieren. Anschließend können Sie ihren Code in die codedatei für den neuen Formularbereich einfügen.

Hinzufügen von benutzerdefiniertem Code zu einem Formularbereich

Der Microsoft.Office.Tools.Outlook Namespace bietet Zugriff auf Klassen, die den Formularbereich, das Outlook-Element, das den Formularbereich anzeigt, und andere nützliche Elemente. Das Outlook-Formularbereich-Element fügt automatisch einen Verweis auf diese Assembly im Projekt hinzu und fügt die entsprechende using - oder Imports-Anweisung oben in der Formularbereichscodedatei ein.

Sie können Klassen, Methoden und Eigenschaften im Microsoft.Office.Interop.Outlook Namespace verwenden, um die meisten Programmieraufgaben in Outlook auszuführen. Weitere Informationen zum Outlook-Objektmodell finden Sie in der Übersicht über das Outlook-Objektmodell. Beispiele für typische Aufgaben, die das Outlook-Objektmodell verwenden, finden Sie unter Outlook-Lösungen.

Behandeln von Formularbereichsereignissen

Das Outlook-Formularbereich-Element fügt der Formularbereichscodedatei automatisch die folgenden drei Ereignishandler hinzu.

Erstellen des Projekts

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

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

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

  Outlook verwendet diese Informationen, um die Formularbereiche zu laden.

Debuggen eines Formularbereichs

Sie können ein Outlook VSTO-Add-In debuggen, das einen Formularbereich enthält, genau wie andere Visual Studio-Projekte debuggen würden. Wenn Sie den Visual Studio-Debugger starten, startet Visual Studio Outlook automatisch.

Um den Formularbereich anzuzeigen, müssen Sie das entsprechende Outlook-Element öffnen. Wenn beispielsweise ein angrenzender Formularbereich am Ende eines E-Mail-Elements angefügt wird, öffnen Sie ein E-Mail-Element.

Bereitstellen eines Formularbereichs

Formularbereiche werden automatisch mit dem zugeordneten Outlook VSTO-Add-In bereitgestellt. Daher müssen Sie keine speziellen Aufgaben ausführen, um einen Formularbereich bereitzustellen. Weitere Informationen zum Bereitstellen von VSTO-Add-Ins finden Sie unter Bereitstellen einer Office-Lösung.

Zugehörige Themen