_FormRegionStartup.GetFormRegionManifest(String, Int32) Methode

Definition

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

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

public:
 System::Object ^ GetFormRegionManifest(System::String ^ FormRegionName, int LCID);

public object GetFormRegionManifest (string FormRegionName, int LCID);

Public Function GetFormRegionManifest (FormRegionName As String, LCID As Integer) As Object

Parameter

FormRegionName

String

Der Name des Formularbereichs, der bei der Registrierung des Formularbereichs in der Windows-Registrierung verwendet wird.

LCID

Int32

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.

Gibt zurück

Object

Ein Objekt , das 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. Weitere Informationen zum XML-Schema des Formularbereichs finden Sie in der MICROSOFT OUTLOOK 2010 XML-Schemareferenz in der MSDN Library.

Hinweise

Diese Methode sollte durch ein Add-In implementiert und von Outlook aufgerufen werden. Als Teil der FormRegionStartup -Schnittstelle stellen diese Methode und die GetFormRegionIcon(String, Int32, OlFormRegionIcon) -Methode einen Mechanismus bereit, über den ein Add-In einen Formularbereich registrieren und Outlook das XML-Manifest und die Symbole für den Formularbereich bereitstellen kann.

Wenn ein Add-In das XML-Manifest für einen Formularbereich bereitstellen soll, geben Sie die ProgID des Add-Ins beim Registrieren des Formularbereichs in der Windows-Registrierung an. Weitere Informationen zum Registrieren eines Formularbereichs finden Sie unter Angeben von Formularbereichen in derGetFormRegionManifest-Methode der Windows-Registrierung der FormRegionStartup-Schnittstelle . Beachten Sie, dass diese Methode ohne jegliche Angabe einer ProgID in der Windows-Registrierung von Outlook nicht aufgerufen wird.

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 zur Verwendung eines Add-Ins zum Angeben 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. Auch, wenn Sie alle ProgID in der Windows-Registrierung nicht angeben, wird Outlook nicht die GetFormRegionManifest und GetFormRegionIcon -Methoden aufrufen.

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