Richtlinien zum Erstellen von Outlook-Formularbereichen

Článek
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.

Anhand der folgenden Informationen können Formularbereiche optimiert und mögliche Probleme vermieden werden.

Verwenden von Formularbereichsnamen.
Deaktivieren von Formularbereichsvererbung.
Grundlegendes zu Typen und Nachrichtenklassennamen.
Entwerfen von benachbarten Formularbereichen für den Lesebereich.
Verwenden von optimalen Symbolgrößen.

Weitere Informationen zu Formularbereichen finden Sie unter Erstellen von Outlook-Formularbereichen.

Verwenden von Formularbereichsnamen

Der Formularbereich wird mit mehreren Namen beschrieben. Es ist wichtig, den Unterschied zwischen diesen Namen und den Einfluss auf den Formularbereich zu kennen. In der folgenden Tabelle wird jeder Name beschrieben.

Formularbereichsname	Beschreibung
Formularbereichs-Elementname	Der Name, den Sie für das Outlook-Formularbereich-Element im Dialogfeld Neues Element hinzufügen angeben. Dies ist der Name der Formularbereich-Codedatei, die im Projektmappen-Explorer angezeigt wird.
FormRegionName-Eigenschaft	Dieser Name wird auf der Seite Geben Sie eine Beschreibung ein, und wählen Sie die Anzeigeeinstellungen aus des Assistenten Neuer Outlook-Formularbereich angegeben. Dieser Name wird als FormRegionName-Eigenschaft im Fenster Eigenschaften angezeigt. Verwenden Sie die FormRegionName-Eigenschaft, um die Bezeichnung anzugeben, durch die der Formularbereich in der Outlook-Benutzeroberfläche identifiziert wird. In separaten Formularbereichen wird dieser Name als Schaltfläche auf der Multifunktionsleiste des Outlook-Elements angezeigt. In benachbarten Formularbereichen wird dieser Name als Headertext über dem Formularbereich angezeigt.
Microsoft.Office.Tools.Outlook.FormRegionName-Attribut	Wird dem Projekt ein Outlook-Formularbereich-Element hinzugefügt, legt Visual Studio Tools for Office diese Eigenschaft auf den vollqualifizierten Namen des Formularbereichs fest. Der standardmäßige vollqualifizierte Name ist der Name des Add-Ins, das durch einen Punkt mit dem Namen des Formularbereichs verbunden ist (beispielsweise OutlookAddIn1.FormRegion1). Dieser vollqualifizierte Name wird am Anfang der Factoryklasse für den Formularbereich auch als Attribut angezeigt. Verwenden Sie das Microsoft.Office.Tools.Outlook.FormRegionName-Attribut, um den Formularbereich in allen Outlook-Add-Ins eindeutig zu identifizieren. Der Wert des Microsoft.Office.Tools.Outlook.FormRegionName-Attributs kann nicht durch Umbenennen des Formularbereichs oder durch Ändern der FormRegionName-Eigenschaft geändert werden. Um diesen Namen zu ändern, muss das Microsoft.Office.Tools.Outlook.FormRegionName-Attribut in der Formularbereich-Codedatei geändert werden.

Formularbereichs-Elementname

Der Name, den Sie für das Outlook-Formularbereich-Element im Dialogfeld Neues Element hinzufügen angeben. Dies ist der Name der Formularbereich-Codedatei, die im Projektmappen-Explorer angezeigt wird.

FormRegionName-Eigenschaft

Dieser Name wird auf der Seite Geben Sie eine Beschreibung ein, und wählen Sie die Anzeigeeinstellungen aus des Assistenten Neuer Outlook-Formularbereich angegeben. Dieser Name wird als FormRegionName-Eigenschaft im Fenster Eigenschaften angezeigt.

Verwenden Sie die FormRegionName-Eigenschaft, um die Bezeichnung anzugeben, durch die der Formularbereich in der Outlook-Benutzeroberfläche identifiziert wird. In separaten Formularbereichen wird dieser Name als Schaltfläche auf der Multifunktionsleiste des Outlook-Elements angezeigt.

In benachbarten Formularbereichen wird dieser Name als Headertext über dem Formularbereich angezeigt.

Microsoft.Office.Tools.Outlook.FormRegionName-Attribut

Wird dem Projekt ein Outlook-Formularbereich-Element hinzugefügt, legt Visual Studio Tools for Office diese Eigenschaft auf den vollqualifizierten Namen des Formularbereichs fest. Der standardmäßige vollqualifizierte Name ist der Name des Add-Ins, das durch einen Punkt mit dem Namen des Formularbereichs verbunden ist (beispielsweise OutlookAddIn1.FormRegion1).

Dieser vollqualifizierte Name wird am Anfang der Factoryklasse für den Formularbereich auch als Attribut angezeigt.

Verwenden Sie das Microsoft.Office.Tools.Outlook.FormRegionName-Attribut, um den Formularbereich in allen Outlook-Add-Ins eindeutig zu identifizieren. Der Wert des Microsoft.Office.Tools.Outlook.FormRegionName-Attributs kann nicht durch Umbenennen des Formularbereichs oder durch Ändern der FormRegionName-Eigenschaft geändert werden. Um diesen Namen zu ändern, muss das Microsoft.Office.Tools.Outlook.FormRegionName-Attribut in der Formularbereich-Codedatei geändert werden.

Deaktivieren von Formularbereichvererbung

Standardmäßig erbt eine benutzerdefinierte Nachrichtenklasse alle Formularbereichzuordnungen der Basisnachrichtenklasse. Beispielsweise wird eine Nachrichtenklasse mit der Bezeichnung IPM.Task.Contoso von IPM.Task abgeleitet. Daher erbt IPM.Task.Contoso die Formularbereichzuordnungen von IPM.Task.

Soll der Formularbereich abgeleiteten Nachrichtenklassen zugeordnet werden, legen Sie die ExactMessageClass-Eigenschaft des Formularbereichs auf true fest. Wird ein benachbarter Formularbereich IPM.Task zugeordnet und die ExactMessageClass-Eigenschaft auf true festgelegt, wird der Formularbereich nur an den unteren Bereich des Standardaufgabenformulars angehängt. Der Formularbereich wird nicht an den unteren Bereich von beliebigen angepassten Versionen eines standardmäßigen Aufgabenformulars angehängt.

Grundlegendes zu Typen und Nachrichtenklassennamen

Der Typname eines Outlook-Elements unterscheidet sich vom Namen der Nachrichtenklasse eines Outlook-Elements. Beispielsweise ist der Typname eines RSS-Elements Microsoft.Office.Interop.Outlook.PostItem. Der Nachrichtenklassenname eines RSS-Elements ist IPM.Post.RSS.

Verwenden Sie den Typnamen, um auf ein Outlook-Element in Code zu verweisen. Eine Liste der Typnamen finden Sie unter Zuordnen eines Formularbereichs zu einer Outlook-Nachrichtenklasse.

Verwenden Sie den Nachrichtenklassennamen von Outlook-Elementen im Assistenten Neuer Outlook-Formularbereich, um das Element dem Formularbereich zuzuordnen. Eine Liste der gültigen Nachrichtenklassennamen finden Sie unter Zuordnen eines Formularbereichs zu einer Outlook-Nachrichtenklasse.

Entwerfen von benachbarten Formularbereichen für den Lesebereich

Im Outlook-Lesebereich kann die Vorschau eines Outlook-Elements ohne Öffnen des Elements angezeigt werden. Der Lesebereich ist nur für Lesezwecke vorgesehen. Daher verhalten sich Eingabesteuerelemente, die Sie einem benachbarten Formularbereich hinzufügen (beispielsweise ein Textfeld), unter Umständen nicht wie erwartet, wenn das Element und der Formularbereich im Lesebereich geöffnet sind.

Beispiel: Ist ein Element, das über einen benachbarten Formularbereich verfügt, im Lesebereich geöffnet, kann folgende Situation eintreten:

Wählen Sie in einem Textfeld, das sich im Formularbereich befindet, Text aus.
Drücken Sie ENTF.
Anstelle des Texts im Textfeld wird das gesamte E-Mail-Element gelöscht.

Wird ein benachbarter Formularbereich entworfen, der Eingabesteuerelemente beinhaltet, testen Sie die Steuerelemente im Lesebereich, um sicherzustellen, dass sie ordnungsgemäß funktionieren. Fügen Sie ggf. benutzerdefinierten Code hinzu, durch den Steuerelemente mit unerwartetem Verhalten deaktiviert werden.

Sie können auch die ShowInspectorRead-Eigenschaft des Formularbereichs auf False festlegen. Somit kann der Formularbereich nicht im Lesebereich verwendet werden.

Verwenden von optimalen Symbolgrößen

Sie können angeben, welche Symbole im Formularbereich angezeigt werden sollen. Legen Sie dazu Symboleigenschaften in der Eigenschaftsgruppe Symbole des Fensters Eigenschaften fest. Verwenden Sie die folgenden Richtlinien, um die beste visuelle Qualität zu erzielen:

Verwenden Sie für das Seitensymbol eine Portable Network Graphics (PNG)-Datei.
Fenstersymbole sollten eine Auflösung von 32 Pixel x 32 Pixel besitzen.
Alle anderen Symbole sollten eine Auflösung von 16 Pixel x 16 Pixel besitzen.

Das Seitensymbol wird auf der Multifunktionsleiste eines Inspektors für Elemente angezeigt, die über folgende Formularbereiche verfügen: Separat, Ersetzung oder Alle ersetzen.

Das Fenstersymbol erscheint im Benachrichtigungsbereich und im ALT+TAB-Dialogfeld für geöffnete Elemente, die die Formularbereiche Ersetzung oder Alles ersetzen anzeigen.