FormRegionStartup.GetFormRegionManifest-Methode (Outlook)

Ruft das XML-Manifest für einen Formularbereich ab.

Syntax

Ausdruck. GetFormRegionManifest( _FormRegionName_ , _LCID_ )

Ausdruck Eine Variable, die ein FormRegionStartup-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
FormRegionName	Erforderlich	String	Der Name des Formularbereichs, der bei der Registrierung des Formularbereichs in der Windows-Registrierung verwendet wird.
LCID	Erforderlich	Long	Die Gebietsschema-ID, die die aktuell von Outlook verwendete Sprache identifiziert. Dieser Wert wird verwendet, um die Lokalisierungszeichenfolgen für den Formularbereich abzurufen, die dieser Sprache entsprechen.

Rückgabewert

Eine Variant, die das XML-Manifest für einen Formularbereich darstellt. Diese XML-Zeichenfolge enthält Merkmale des Formularbereichs wie den Anzeigenamen (gemäß der Title-Element), beliebige dazugehörige Layoutdatei oder -add-in, unterstützte Benutzeraktionen und Lokalisierung Zeichenfolgen. Die XML-Daten muss das Formular Region XML-Schema entsprechen. For more information on the form region XML schema, see the Microsoft Outlook 2010 XML Schema Reference in the MSDN Library.

HinwBemerkungeneise

Diese Methode sollte durch ein Add-In implementiert und von Outlook aufgerufen werden. Als Teil der FormRegionStartup -Schnittstelle bieten diese und die GetFormRegionIcon -Methode einen Mechanismus, mit dessen Hilfe ein Add-In einen Formularbereich registrieren und Outlook das XML-Manifest sowie die Symbole für den Formularbereich bereitstellen kann.

Wenn Sie ein Add-in, das XML-Manifest für einen Formularbereich bereitstellen möchten, geben Sie die ProgID des Add-Ins, wenn Sie den Formularbereich in der Windows-Registrierung registrieren. Weitere Informationen zum Registrieren eines Formularbereichs finden Sie unter Angeben von Formularbereichen in der Windows-Registrierung. Das Add-in muss die GetFormRegionManifest -Methode des FormRegionStartup -Schnittstelle implementieren. Beachten Sie, dass Outlook diese Methode nicht aufruft, wenn Sie keine ProgID in der Windows-Registrierung angeben.

Vertrauende Seite auf ein Add-in zum Bereitstellen von XML-Manifest für einen Formularbereich bedeutet, dass Sie das Add-in für den Formularbereich Symbole bereitstellen zulassen. Das Add-in muss auch die GetFormRegionIcon der FormRegionStartup -Schnittstelle implementieren. Outlook ruft GetFormRegionIcon -add-in angegebenen Symbole für den Formularbereich zu erhalten. Weitere Informationen zum Verwenden eines Add-Ins für die Angabe von Symbolen finden Sie unter Vorgehensweise: Verwenden eines Add-Ins zum Angeben von Symbolen für einen Formularbereich.

Beim Start von Outlook liest die Liste der von Formularbereichen in der Windows-Registrierung und speichert die Daten. Basierend auf diese Daten, wenn Outlook bemerkt, dass ein Add-in angegeben wurde, geben Sie das XML-Manifest für einen Formularbereich, verwendet Outlook die ProgID gemäß den zwischengespeicherten Daten und Aufruf die GetFormRegionManifest -Methode implementiert, durch dieses Add-in, um den XML-Code abzurufen, den Formularbereich angezeigt werden muss. Wenn das XML-Manifest nicht gültig ist und nicht das Formular Region XML-Schema entspricht, wird Outlook nicht den Formularbereich geladen werden. Wenn Sie keine ProgID in der Windows-Registrierung angeben, ruft Outlook die Methoden GetFormRegionManifest und GetFormRegionIcon nicht auf.

Bei der Bereitstellung des XML-Manifests durch das Add-In werden folgende Elemente von Outlook ignoriert:

• name : Outlook ignoriert den für dieses Element angegebenen Wert und verwendet den Namen, der für den Formularbereich in der Registrierung angegeben wurde.

• layoutFile : Outlook ignoriert dieses Element, da ein Add-In diesen Formularbereich erweitert.

• addin : Outlook verwendet den Wert, dem ein Gleichheitszeichen (=) in der Registrierung vorangestellt ist, als ProgID des Add-Ins.

• file-Attribut von stringOverride : Outlook ignoriert jede sekundäre Lokalisierungsdatei, die durch das stringOverride-Element angegeben wird. Das Add-In kann GetFormRegionManifest implementieren, um das XML-Manifest für die Zeichenfolgenlokalisierung für die angegebene LCID inline zurückzugeben, oder die Zeichenfolgenlokalisierung auf andere Weise verwalten, z. B. mithilfe .NET Framework Lokalisierung, und dann das entsprechende XML-Manifest für die angegebene LCID zurückgeben.

Siehe auch

FormRegionStartup-Schnittstelle

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.