_FormRegionStartup.GetFormRegionManifest(String, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 ObjectParameter
- 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
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: