Angeben des Speicherorts eines Formularbereichs in einem benutzerdefinierten Formular

Artikel
04/07/2023

Ein Formularbereich ist ein Teil benutzerdefinierter Benutzeroberfläche, das einem Formular hinzugefügt wird. Sie können festlegen, dass der Formularbereich auf eine von mehreren möglichen Arten in einem benutzerdefinierten Formular angezeigt wird. Zu diesem Zweck geben Sie die elemente formRegionType und displayAfter des XML-Schemas des Formularbereichs in der entsprechenden XML-Datei des Formularbereichmanifests an.

Auf der Standardseite

Es gibt mehrere Arten, um Formularbereiche auf der Standardseite eines Standardformulars anzuzeigen.

So fügen Sie der Standardseite einen Formularbereich hinzu

Geben Sie in der XML-Datei des Formularbereichmanifests adjoining als Wert des formRegionType -Elements an.

Der Formularbereich wird der Standardseite des Originalstandardformulars am unteren Rand hinzugefügt und in einem Inspektor oder im Lesebereich angezeigt.

Um beispielsweise einen Formularbereich am unteren Rand der Standardseite des Standardnachrichtenformulars hinzuzufügen, können Sie Folgendes in der XML-Datei des Formularbereichmanifests für den Formularbereich angeben:

<formRegionType>adjoining</formRegionType>

Verwenden Sie das resultierende benutzerdefinierte Formular, um Elemente derselben Nachrichtenklasse wie das ursprüngliche Standardformular anzuzeigen, oder Sie können dem benutzerdefinierten Formular eine abgeleitete Nachrichtenklasse zuweisen und das benutzerdefinierte Formular verwenden, um nur Elemente der abgeleiteten Nachrichtenklasse anzuzeigen.

So fügen Sie der Standardseite mehrere Formularbereiche hinzu

Geben Sie für jeden Formularbereich in der entsprechenden XML-Datei des Formularbereichmanifests adjoining als Wert des formRegionType -Elements an.
Geben Sie für jeden Formularbereich, mit Ausnahme des Formularbereichs, der als erster auf der Standardseite angezeigt wird, in der entsprechenden XML-Datei des Formularbereichmanifests den internen Namen des Formularbereichs, der diesem Formularbereich vorangeht, als Wert des displayAfter -Elements an.

Der erste Formularbereich wird am unteren Rand der Standardseite des ursprünglichen Standardformulars hinzugefügt und von den anderen Formularbereichen in der Reihenfolge angefügt, die Sie im entsprechenden displayAfter-Element angegeben haben.

Wenn Sie beispielsweise die drei Formularbereiche A, B und C mit den internen Namen FormRegionA, FormRegionB und FormRegionC in der Reihenfolge A, B und C anzeigen möchten, geben Sie Folgendes in der XML-Datei des Formularbereichmanifests von A an:

<formRegionType>adjoining</formRegionType>

In der XML-Datei des Formularbereichmanifests von B geben Sie Folgendes an:

<formRegionType>adjoining</formRegionType>
<displayAfter>FormRegionA</displayAfter>

In der XML-Datei des Formularbereichmanifests von C geben Sie Folgendes an:

<formRegionType>adjoining</formRegionType>
<displayAfter>FormRegionB</displayAfter>

Hinweis

Verwenden Sie das displayAfter-Element , um die Reihenfolge mehrerer angrenzender Formularbereiche in einem benutzerdefinierten Formular anzugeben. However, this order is only valid the first time that the form is displayed for the user on the local computer. The user has the option to change the order of adjoining form regions by opening the form and moving the form regions up or down on the default page through the form region header context menu. Outlook caches the updated order and uses the cached order on subsequent displays of the form.

So ersetzen Sie die gesamte Standardseite durch einen Formularbereich

Geben Sie in der XML-Datei des Formularbereichmanifests replace als Wert des formRegionType -Elements an.
Wenn Sie den Formularbereich in der Windows-Registrierung unter dem lokalen Computerschlüssel (als HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) oder unter dem aktuellen Benutzerschlüssel (als HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions) registrieren, erstellen Sie einen gesonderten Schlüssel für die abgeleitete Nachrichtenklasse für diesen Formularbereich. Fügen Sie einen Wert vom Typ REG_SZ hinzu, indem Sie den internen Namen des Formularbereichs als Namen des Schlüssels und den vollständigen Namen des Dateipfads zur XML-Datei des Formularbereichmanifests als Datenwert des Schlüssels angeben.

When you are "replacing" the default page of a standard form, you are in reality using the standard form as a template and creating a new custom form that has your form region as the default page. Wenn das ursprüngliche Standardformular andere Formularseiten oder separate Formularbereiche enthält, bleiben diese als Teil des benutzerdefinierten Formulars erhalten.

Sie müssen dem resultierenden benutzerdefinierten Formular eine abgeleitete Nachrichtenklasse zuweisen und das Formular verwenden, um Elemente dieser Nachrichtenklasse anzuzeigen.

Sie haben beispielsweise einen Formularbereich erstellt, der den internen Namen CustomPage und die XML-Manifestdatei des Formularbereichs CustomPage.xml in c:\Form Regions aufweist. To use the form region to replace the default page of the standard Message form, you can specify the following in the form region manifest XML file of CustomPage:

<formRegionType>replace</formRegionType>

Wenn Sie diesen Formularbereich in der Windows-Registrierung registrieren, dürfen Sie nicht die Nachrichtenklasse des Originalstandardformulars IPM.Note angeben, sondern müssen eine abgeleitete Nachrichtenklasse, wie z. B. IPM.Note.CustomPage, angeben. In diesem Beispiel registrieren Sie den Formularbereich unter dem aktuellen Benutzerschlüssel HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, indem Sie eine Schlüssel-IPM erstellen. Note.CustomPage. Anschließend fügen Sie einen Wert vom Typ REG_SZ hinzu und geben dabei den internen Namen CustomPage des Formularbereichs als Namen des Schlüssels und den vollständigen lokalen Dateipfadnamen zur XML-Datei des Formularbereichmanifests c:\Form Regions\CustomPage.xmlals Daten des Schlüssels an.

So ersetzen Sie das gesamte Standardformular durch einen Formularbereich

Geben Sie in der XML-Datei des Formularbereichmanifests replaceall als Wert des formRegionType -Elements an.
Wenn Sie den Formularbereich in der Windows-Registrierung unter dem lokalen Computerschlüssel (als HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) oder unter dem aktuellen Benutzerschlüssel (als HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions) registrieren, erstellen Sie einen gesonderten Schlüssel für die abgeleitete Nachrichtenklasse für diesen Formularbereich. Fügen Sie einen Wert vom Typ REG_SZ hinzu, indem Sie den internen Namen des Formularbereichs als Namen des Schlüssels und den vollständigen Namen des Dateipfads zur XML-Datei des Formularbereichmanifests als Datenwert des Schlüssels angeben.

When you are "replacing" the entire standard form with a form region, you are in reality using the standard form as a template and creating a new custom form that has the form region as the default page. Wenn das ursprüngliche Standardformular andere Formularseiten oder separate Formularbereiche enthält, verbleiben diese nicht als Teil des benutzerdefinierten Formulars.

Sie müssen dem resultierenden benutzerdefinierten Formular eine abgeleitete Nachrichtenklasse zuweisen und das Formular verwenden, um Elemente dieser Nachrichtenklasse anzuzeigen.

Sie haben beispielsweise einen Formularbereich erstellt, der den internen Namen CustomMessage und die XML-Manifestdatei des Formularbereichs CustomMessage.xml in c:\Form Regions aufweist. To use the standard Message form as the template for a new custom form that will contain CustomMessage as the default page, you can specify the following in the form region manifest XML file of CustomMessage:

<formRegionType>replaceall</formRegionType>

Wenn Sie diesen Formularbereich in der Windows-Registrierung registrieren, geben Sie eine abgeleitete Nachrichtenklasse an, z. B . IPM. Note.CustomMessage. In diesem Beispiel registrieren Sie den Formularbereich unter dem aktuellen Benutzerschlüssel HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, indem Sie eine Schlüssel-IPM erstellen. Note.CustomMessage. Anschließend fügen Sie einen Wert vom Typ REG_SZ hinzu und geben dabei den internen Namen CustomMessage des Formularbereichs als Namen des Schlüssels und den vollständigen lokalen Dateipfadnamen zur XML-Datei des Formularbereichmanifests c:\Form Regions\CustomMessage.xmlals Daten des Schlüssels an.

Auf anderen Seiten als der Standardseite

Sie können einem Standardformular mindestens einen Formularbereich als gesonderte Seite hinzufügen.

So fügen Sie einen Formularbereich als separate Seite hinzu

Geben Sie in der XML-Datei des Formularbereichmanifests separate als Wert des formRegionType -Elements an.

Der Formularbereich wird hinter allen vorhandenen Seiten des Originalstandardformulars als gesonderte Seite hinzugefügt und als eigenständige Seite in einem Inspektor angezeigt.

Um beispielsweise dem Standardkontaktformular einen Formularbereich als gesonderte Seite hinzuzufügen, können Sie Folgendes in der XML-Datei des Formularbereichmanifests für den Formularbereich angeben:

<formRegionType>separate</formRegionType>

Der Formularbereich wird als gesonderte Seite hinter der Seite Alle Felder des Standardkontaktformulars angezeigt.

So fügen Sie mehrere Formularbereiche als separate Seiten hinzu

Geben Sie für jeden Formularbereich in der entsprechenden XML-Datei des Formularbereichmanifests separate als Wert des formRegionType -Elements an.
Geben Sie für jeden Formularbereich, mit Ausnahme des Formularbereichs, der als erster im benutzerdefinierten Formular angezeigt wird, in der entsprechenden XML-Datei des Formularbereichmanifests den internen Namen des Formularbereichs, der diesem Formularbereich vorangeht, als Wert des displayAfter -Elements an.

Der erste Formularbereich wird als separate Seite des ursprünglichen Standardformulars hinzugefügt und von den anderen Formularbereichen in der Reihenfolge angefügt, die Sie im entsprechenden displayAfter-Element angegeben haben.

Wenn Sie beispielsweise drei separate Formularbereiche (A, B und C) mit den internen Namen FormRegionA, FormRegionB und FormRegionC als separate Seiten in der Reihenfolge A, B und C anzeigen möchten, geben Sie Folgendes in der XML-Datei des Formularbereichmanifests von A an:

<formRegionType>separate</formRegionType>