Angeben von Formularbereichen in der Windows-Registrierung

Artikel
04/07/2023

Um ein Formular auszuführen, das einen Formularbereich auf einem Clientcomputer enthält, müssen Sie den Formularbereich in der Windows-Registrierung registrieren und die Nachrichtenklasse und andere Informationen angeben, die für Microsoft Outlook zum Anzeigen des Formularbereichs erforderlich sind. Diese Informationen umfassen den Anzeigenamen, in dem der Formularbereich in einem Formular angezeigt wird, alle Layoutdateien oder Add-Ins, die den Formularbereich implementieren, alle unterstützten Benutzeraktionen und alle lokalisierten Begriffe für die Benutzeroberfläche. Die Struktur dieser Informationen folgt einem XML-Schema des Formularbereichs. Weitere Informationen zum XML-Schema für Formularbereiche finden Sie in der MICROSOFT OUTLOOK 2010 XML-Schemareferenz in der MSDN Library.

Es sind mehrere Verfahren verfügbar, um diese Informationen zum Formularbereich in der Registrierung anzugeben. Sie können das XML oder einen vollständigen Pfad zu einer XML-Datei, die diese Informationen zum Formularbereich enthält und mit dem Formularbereich-XML-Schema kompatibel ist, ausdrücklich angeben. Wahlweise können Sie auch die ProgID eines Add-Ins angeben, das Outlook die XML-Manifestdatei für den Formularbereich zur Verfügung stellt. Wenn Outlook gestartet wird, wird die Liste der Formularbereiche in der Registrierung gelesen, und die zugehörigen Daten werden zwischengespeichert.

Vorsicht Eine fehlerhafte Bearbeitung der Windows-Registrierung kann Ihr System schwer beschädigen. Bevor Sie Änderungen an der Registrierung vornehmen, sollten Sie alle wichtigen Computerdaten sichern.

Registrieren eines Formularbereichs

Registrieren Sie Formularbereiche unter dem Schlüssel FormRegions in der Windows-Registrierung, unter dem Schlüssel des lokalen Computers (wie HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) oder unter dem aktuellen Benutzerschlüssel (wie HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions). Erstellen Sie unter dem Schlüssel FormRegions einen eigenen Schlüssel für jede Nachrichtenklasse, für die Formularbereiche erstellt wurden. Das E-Mail-Element weist beispielsweise die Nachrichtenklasse IPM.Note auf, sodass Sie alle Formularbereiche, die zum Anzeigen des E-Mail-Elements für den aktuellen Benutzer verwendet werden, unter dem Schlüssel HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions\IPM.Note registrieren.

Anhand der folgenden Schritte wird erläutert, wie ein Formularbereich auf dem lokalen Computer registriert wird:

Schließen Sie Outlook.
Fügen Sie der Registrierung den folgenden Schlüssel hinzu, falls er noch nicht vorhanden ist: HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions.
Fügen Sie unter dem Schlüssel FormRegions einen Schlüssel mit dem Namen der Nachrichtenklasse hinzu, der der Formularbereich zugeordnet ist, sofern dieser Schlüssel nicht bereits vorhanden ist. Um beispielsweise einen Formularbereich für das Kontaktelement zu erstellen, fügen Sie einen Schlüssel mit dem Namen IPM.Contact hinzu, sofern dieser nicht bereits vorhanden ist.
Fügen Sie für diesen Schlüssel einen Wert vom Typ REG_SZ hinzu, und geben Sie den Namen an, der mit dem Namenselement des Formularbereichs identisch sein soll. Dies ist der interne Name für den Formularbereich. der interne Name unterstützt nur ASCII-Zeichen. Geben Sie die Daten als einen der folgenden möglichen Werte an:
- Ausdrücklich als XML, das das Layout, das Verhalten und andere Charakteristika für den Formbereich angibt, und mit dem Formularbereich-XML-Schema kompatibel ist. In diesem Fall müssen Sie den Daten ein Kleiner als-Zeichen (<) voranstellen.
- The ProgID of an add-in that will provide Outlook the XML manifest for the form region. In diesem Fall müssen Sie den Daten ein Gleichheitszeichen (=) vorangestellt haben. Wenn die ProgID eines Add-Ins beispielsweise MyAddinProject1.ConnectClass ist, würden Sie die Daten des Schlüssels als =MyAddinProject1.ConnectClass angeben.
- The full local file path name to a form region XML manifest file that describes the layout, behavior, and other characteristics of the form region. Wenn den Daten kein kleiner als -Zeichen () oder ein Gleichheitszeichen (<=) vorangestellt ist, geht Outlook davon aus, dass es sich bei den Daten um einen Pfadnamen zur XML-Manifestdatei des Formularbereiches handelt. Wenn sich ihre XML-Manifestdatei für den Formularbereich z. B. map.xml unter "c:\Form Regions" befindet, würden Sie die Daten des Schlüssels als c:\Form Regions\map.xmlangeben.

Angeben von Formularbereichen als Ersatz für Standardformulare

In Outlook können Sie das Standardformular aller Outlook-Nachrichtenklassen anpassen, indem Sie dem Formular angrenzende oder separate Formularbereiche hinzufügen. In der folgenden Tabelle sind die Standardformulare und die entsprechenden Nachrichtenklassen in Outlook aufgeführt.

Standardformular	Nachrichtenklasse
Termin	IPM.Appointment
Kontakt	IPM.Contact
Journaleintrag	IPM.Activity
Besprechungsanfrage	IPM. Meeting.Schedule.Request
Nachricht	IPM.Note
Beitrag	IPM.Post
Aufgabe	IPM. Anfrage
Aufgabenanfrage	IPM.Task

Hinweis Sie können keine Formularbereiche für die Outlook-Stammnachrichtenklasse IPM angeben.

Sie können einem Standardformular separate Formularbereiche als zusätzliche Seiten hinzufügen, aber Sie können keine vorhandenen Seiten im Standardformular ersetzen und das Formular für dieselbe Outlook-Nachrichtenklasse beibehalten. Wenn Sie die Standardseite oder alle Seiten eines Standardformulars ersetzen müssen, müssen Sie eine neue Nachrichtenklasse für dieses Formular ableiten, einen Ersatzformularbereich angeben, um die Standardseite zu ersetzen, oder einen Formularbereich ersetzen, um das gesamte Formular zu ersetzen, und diesen Formularbereich für die abgeleitete Nachrichtenklasse registrieren.

Beispiel: Sie können einen Ersatzformularbereich erstellen, der die Seite Allgemein des Kontaktformulars ersetzt, und diesen Formularbereich für eine Nachrichtenklasse registrieren, die von IPM.Contact abgeleitet wurde, wie z. B. IPM.Contact.MyContact. Für die Nachrichtenklasse IPM.Contact kann dieser Formularbereich nicht registriert werden.

Wenn Outlook ein Element öffnet und eine abgeleitete Nachrichtenklasse (z. B . IPM) sieht. Contact.MyContact.Personal.Family) sucht nach einem Ersetzungs- oder allen ersetzen-Formularbereich (d. h. einem Formularbereich, der ein formRegionType-Element aufweist, das gleich "replace " oder "replaceAll") ist und genau der abgeleiteten Nachrichtenklasse IPM entspricht. Contact.MyContact.Personal.Family. Wenn keine genaue Übereinstimmung vorliegt, versucht Outlook IPM. Contact.MyContact.Personal, und wenn dies fehlschlägt, versucht Outlook IPM. Contact.MyContact. Beachten Sie, dass Outlook alle Ersetzungs- oder Ersetzungsformularbereiche für IPM ignoriert. Kontakt. Wenn noch keine genaue Übereinstimmung vorhanden ist, sucht Outlook nach einem beliebigen Formularbereich, bei dem formRegionType gleich dem angrenzenden oder separaten für die abgeleitete Klasse IPM ist. Contact.MyContact.Personal.Family.

Mehrere Formularbereiche für dieselbe Nachrichtenklasse

Wenn ein oder mehrere Add-Ins mehrere Formularbereiche für dieselbe Nachrichtenklasse registrieren, hängt die Anzeigefolge angrenzender Formularbereiche auf der Standardseite sowie die Reihenfolge separater Formularbereiche im Formular von der Reihenfolge ab, in der die Add-Ins installiert wurden, sowie von der Reihenfolge, in der die Add-Ins die Formularbereiche registrieren. Wenn ein Add-In mehrere angrenzende Formularbereiche oder mehrere separate Formularbereiche für eine Nachrichtenklasse angibt, kann das Add-In die Reihenfolge dieser Formularbereiche mithilfe des displayAfter-Elements angeben. Die durch das displayAfter-Element angegebene Reihenfolge hat Vorrang vor der Reihenfolge der Formularbereiche in der Registrierung. Dies ist die einzige Möglichkeit, die Reihenfolge von Formularbereichen in einem Formular mit Add-Ins anzugeben.

Nach der Installation der Formularbereiche auf einem Clientcomputer können Formularbenutzer die Reihenfolge angrenzender Formularbereiche weiter anpassen, indem sie das Formular öffnen und die Formularbereiche auf der Standardseite über das Kontextmenü in der Kopfzeile des Formularbereichs nach oben oder nach unten verschieben.

Beispiel

Es folgt ein Beispiel für den XML-Code für einen Formularbereich für die abgeleitete Nachrichtenklasse IPM. Contact.MapUser. The form region is applied to all users on a computer. The XML file, map.xml, is located in c:\Form Regions.

Um den Formularbereich zu registrieren, erstellen Sie den folgenden Wert in der Windows-Registrierung:

Registrierungswert	Eintrag
Schlüssel	HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions\IPM.Contact.MapUser
Name	MapTab
Typ	REG_SZ
Daten	c:\Form Regions\map.xml

Im Folgenden ist der Inhalt der Datei „map.xml" aufgeführt:

<?xml version="1.0"?> 
<FormRegion xmlns="https://schemas.microsoft.com/office/outlook/12/formregion.xsd">   
    <!-- Internal name --> 
    <name>MapTab</name> 
    <!-- Display name --> 
    <title>Directions</title> 
    <!--  Additive separate form region --> 
    <formRegionType>separate</formRegionType> 
    <!--  Layout file --> 
    <layoutFile>Map.ofs</layoutFile> 
    <!-- Icon for form region in all contexts --> 
    <icons> 
        <default>generic.ico</default> 
    </icons> 
</FormRegion>

Der Formularbereich wird dem Formular als Seite hinzugefügt, die der letzten nicht ausgeblendeten integrierten Seite im Kontaktformular folgt (normalerweise folgt dies der Seite Alle Felder ). The page is titled Directions and has an internal programmatic name "MapTab". Map.xml specifies a layout file and an icon file. Note that all file paths in the xml file can be specified as full file paths, or paths relative to the location of the form region XML manifest file.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über