Erstellen von Outlook-Formularbereichen
Formularbereiche können zum Anpassen von Microsoft Office Outlook-Formularen verwendet werden. Visual Studio bietet erweiterte Tools, die Ihnen das Entwerfen, Entwickeln und Debuggen von Formularbereichen erleichtern.
Gilt für: Die Informationen in diesem Thema gelten für VSTO-Add-In-Projekte für Outlook. Weitere Informationen finden Sie unter features available by Office-App lication and project type.
Dieses Thema enthält die folgenden Informationen:
Vorteile der Verwendung von Formularbereichen
Formularbereiche bieten zahlreiche Verbesserungen gegenüber der traditionellen Outlook-Formularentwicklung:
Anpassen der Standardseite beliebiger Standardformulare.
Hinzufügen von bis zu 12 zusätzlichen Seiten zu einem beliebigen Standardformular.
Ersetzen Sie oder Optimieren beliebiger Standardformulare.
Anzeigen einer benutzerdefinierten Benutzeroberfläche im Lesebereich und in den Inspektoren.
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 über einen Formularbereich verfügen, den Sie in einem anderen Outlook VSTO-Add-In-Projekt verwendet haben, können Sie außerdem Ihren 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 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.
Verwenden Sie den Assistenten, um den Typ des zu erstellenden Formularbereichs auszuwählen. In der folgenden Tabelle werden die einzelnen Formularbereichtypen beschrieben.
| Regionstyp | Beschreibung |
|---|---|
| Trennen | Fügt den Formularbereich als neue Seite in einem Outlook-Formular hinzu. |
| Benachbart | Fügt den Formularbereich am unteren Rand einer Outlook-Standardseite des Formulars hinzu. |
| Ersatz | Fügt den Formularbereich als neue Seite hinzu, die die Standardseite eines Outlook-Formulars ersetzt. |
| Alle ersetzen | Ersetzt das gesamte Outlook-Formular durch den Formularbereich. |
Sie können den Assistenten auch verwenden, um Anzeigebedingungen anzugeben und den Typ des zu erweiternden Formulars 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, besitzt Auswirkungen auf die auf den anderen Seiten des Assistenten verfügbaren Optionen. Wenn Sie z. B. auf der Seite "Neues Outlook-Formularbereich erstellen" angrenzende oder "Trennen" auswählen, sind die Felder "Titel" und "Beschreibung" im beschreibenden Text "Angeben" nicht verfügbar, und wählen Sie die Seite mit den Anzeigeeinstellungen aus. Der Grund besteht darin, dass Outlook diese Felder beim Anzeigen eines benachbarten oder getrennten Formularbereichs nicht verwendet.
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 Formularbereich-Codedatei. 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 Formularbereichereignissen hinzu.
Eine Codedatei des Formularbereich-Designers. Diese Datei beinhaltet vom Formularbereich-Designer generierten Code und sollte nicht direkt bearbeitet werden.
Eine Outlook-Formularspeicherdatei (OFS).
Hinweis
Diese Datei wird dem Projekt nur hinzugefügt, wenn Sie einen Formularbereich importieren, der in Outlook entworfenen wurde.
Formularbereich-Factoryklasse
Die Formularbereich-Codedatei enthält eine partielle Klasse, die die IFormRegionFactory-Schnittstelle implementiert. Dies ist die Formularbereichsfactory-Klasse. Die Formularbereichsfactory-Klasse ist für das Erstellen neuer Instanzen des Formularbereichs verantwortlich.
Sie finden diese Klasse, indem Sie den Bereich "Formularbereich 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.
Ein Großteil der Formularbereichsfactory-Klasse wird in der Codedatei des Formularbereich-Designers implementiert. Allerdings wird der FormRegionInitializing-Ereignishandler in der Formularbereich-Codedatei bereitgestellt. Sie können diesen Ereignishandler zum Angeben verwenden, ob Outlook den Formularbereich anzeigen soll. Weitere Informationen finden Sie unter Behandeln von Formularbereichsereignissen.
Hinzufügen eines vorhandenen Formularbereichs zu Ihrem Projekt
Wenn Sie über einen Outlook-Formularbereich verfügen, den Sie in einem anderen Outlook-Projekt verwendet haben, können Sie diesen in Ihrem aktuellen Outlook VSTO-Add-In-Projekt wiederverwenden, indem Sie mit 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) mithilfe des Dialogfelds "Vorhandenes Element hinzufügen" hinzufügen. Allerdings können Sie einen neuen Formularbereich durch Importieren einer OSF-Datei (Outlook Form Storage) erstellen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen eines Formularbereichs zu einem Outlook-Add-In-Projekt.
Verwenden des Formularbereich-Designers
Der Formularbereich-Designer unterstützt Sie beim Entwerfen des Layouts und des Erscheinungsbilds 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.
Hinweis
Sie finden Eigenschaften, die sich auf die Art und Weise auswirken, wie der Formularbereich in Outlook unter dem Manifestknoten im Eigenschaftenfenster angezeigt wird.
Der Formularbereich-Designer ist nur verfügbar, wenn Sie im Assistenten "Neuer Outlook-Formularbereich" die Option "Formularbereich entwerfen" auswählen, wie Sie die Formularbereichsseite des Assistenten für den neuen Outlook-Formularbereich erstellen möchten.
Zum Öffnen des Formularbereich-Designers stehen drei Möglichkeiten zur Verfügung:
Doppelklicken Sie in Projektmappen-Explorer auf die Codedatei des Formularbereichs.
Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei des Formularbereichs, und klicken Sie dann auf "Designer anzeigen".
Wählen Sie in 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 systemeigenen 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. Systemeigene Outlook-Steuerelemente ermöglichen es Ihnen, Outlook-Daten zur Entwurfszeit zu binden. Allerdings können Sie den Formularbereich-Designer nicht zum Hinzufügen verwalteter Steuerelemente oder zum Ändern des Entwurfs des Formularbereichs verwenden.
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 "Formularbereich auswählen" die Option "Importieren einer Outlook-Formularspeicherdatei (OFS)" 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 die Steuerelementereignisse in der Formularbereich-Codedatei behandeln.
Wählen Sie ein Ereignis aus der Methodennamenliste oben im Code-Editor aus, um Ereignisse in einem Visual Basic-Projekt zu behandeln.
Um Ereignisse in einem C#-Projekt zu behandeln, abonnieren Sie Steuerelementereignisse in der Methode FormRegionShowing. Weitere Informationen finden Sie unter How to: Subscribe to and unsubscribe from events (C# programming guide).
Sie können die Eigenschaften von Formularbereichen in der Methode InitializeManifest der Formularbereichsfactory-Klasse ändern.
Hinweis
Um einen Formularbereich zu importieren, müssen Sie in einem Projekt arbeiten, das als Ziel dieselbe Version von Outlook verwendet, die Sie auf dem Entwicklungscomputer installiert haben. Wenn Sie beispielsweise Outlook 2010 installiert haben, funktioniert das Importieren eines Formularbereichs nur in einem Projekt, das mit der Outlook 2010-Add-In-Projektvorlage erstellt wurde.
Aktualisieren des Entwurfs eines importierten Formularbereichs
Sie können Steuerelemente für den Formularbereich hinzufügen, entfernen oder ändern. Bevor Sie diese Aufgaben ausführen, erstellen Sie eine Sicherung des Codes, den Sie der Formularbereich-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 neue Formularbereich-Codedatei einfügen.
Hinzufügen von benutzerdefiniertem Code zu einem Formularbereich
Der Namespace Microsoft.Office.Tools.Outlook ermöglicht Ihnen den Zugriff auf Klassen, die den Formularbereich darstellen, das Outlook-Element, das den Formularbereich angezeigt, 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 Namespace Microsoft.Office.Interop.Outlook verwenden, um die meisten Outlook-Programmieraufgaben 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.
| Ereignis | BESCHREIBUNG |
|---|---|
| FormRegionInitializing | Tritt auf, bevor der Formularbereich initialisiert wird. Sie können die Bedingungen in diesem Ereignishandler überprüfen, um zu ermitteln, ob Outlook den Formularbereich anzeigen soll. Weitere Informationen finden Sie unter How to: Prevent Outlook from displaying a form region. |
| FormRegionShowing | Tritt nach dem Erstellen einer Instanz des Formularbereichs, jedoch vor dem Anzeigen des Formularbereichs auf. |
| FormRegionClosed | Tritt auf, bevor der Formularbereich geschlossen wird. |
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:
Einen Schlüssel für jede Nachrichtenklasse, die mindestens einem Formularbereich zugeordnet ist.
Einen Eintrag für jeden Formularbereich und einen zugeordneten Wert, der den Namen des Outlook VSTO-Add-Ins darstellt.
Outlook verwendet diese Informationen zum Laden der Formularbereiche.
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. Öffnen Sie z. B. ein E-Mail-Element, wenn ein benachbarter Formularbereich am Ende des E-Mail-Elements angefügt wird.
Bereitstellen eines Formularbereichs
Formularbereiche werden automatisch mit dem zugehörigen Outlook VSTO-Add-In bereitgestellt. Daher müssen Sie keine besonderen 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
| Titel | Beschreibung |
|---|---|
| Richtlinien zum Erstellen von Outlook-Formularbereichen | Enthält Informationen, mit denen Sie Formularbereiche optimieren und potenzielle Probleme vermeiden können. |
| Vorgehensweise: Hinzufügen eines Formularbereichs zu einem Outlook-Add-In-Projekt | Zeigt, wie Sie einen Formularbereich erstellen, um ein Standard- oder benutzerdefiniertes Microsoft Office Outlook-Formular mithilfe des Assistenten für den neuen Outlook-Formularbereich zu erweitern. |
| Zuordnen eines Formularbereichs zu einer Outlook-Nachrichtenklasse | Erläutert, wie angegeben wird, welche Elemente von Microsoft Office Outlook einen Formularbereich anzeigen, indem der Formularbereich der Nachrichtenklasse jedes Elements zugeordnet wird. |
| Exemplarische Vorgehensweise: Entwerfen eines Outlook-Formularbereichs | Zeigt, wie ein benutzerdefinierter Formularbereich entworfen wird, der als neue Seite im Inspektor-Fenster eines Kontaktelements angezeigt wird. |
| Exemplarische Vorgehensweise: Importieren eines Formularbereichs, der in Outlook entworfen wurde | Zeigt, wie Sie einen Formularbereich in Microsoft Office Outlook entwerfen und dann den Formularbereich mithilfe des Assistenten für den neuen Outlook-Formularbereich in ein Outlook VSTO-Add-In-Projekt importieren. |
| Zugreifen auf einen Formularbereich zur Laufzeit | Beschreibt, wie Sie Code zum Einblenden, Ausblenden oder Ändern von Steuerelementen in einem Formularbereich schreiben und Benutzern ermöglichen, den Code aus anderen Bereichen im Projekt mithilfe der Klasse Globals auszuführen. |
| Vorgehensweise: Verhindern, dass Outlook einen Formularbereich anzeigt | Zeigt, wie verhindert wird, dass Microsoft Office Outlook einen Formularbereich für ein bestimmtes Element anzeigt. |
| Zeigt, wie auf das Outlook-Element zugegriffen wird, in dem ein Formularbereich angezeigt wird. | |
| Benutzerdefinierte Aktionen in Outlook-Formularbereichen | Beschreibt, wie es Benutzern ermöglicht wird, auf ein Outlook-Element zu reagieren. |