Share via


Verwenden eines Add-Ins zum Angeben von Symbolen für einen Formularbereich

Verwenden Sie ein Add-In, um die benutzerdefinierten Symbole anzugeben, die Sie verwenden möchten, um den Status eines Elements im Explorer, Inspektor und Menüband zu identifizieren. In der XML-Datei des Formularbereichmanifests, die zum Registrieren des Formularbereichs verwendet wird, können Sie das Add-In angeben, von dem der Formularbereich erweitert wird, sowie die Umstände, unter denen das benutzerdefinierte Symbol zum Einsatz kommen soll. Bei Eintritt der angegebenen Umstände wird das geeignete Symbol von Outlook vom Add-In abgerufen.

So verwenden Sie ein Add-In zum Angeben eines Symbols für einen Formularbereich

  1. Implementieren Sie die FormRegionStartup-Schnittstelle .

    Alle Add-Ins, die Formularbereiche erweitern, müssen die FormRegionStartup-Schnittstelle implementieren. Outlook ruft diese Schnittstelle auf, um Layoutspeicherdaten für einen Formularbereich abzurufen. Weitere Informationen zu Add-Ins für Formularbereiche finden Sie unter Erweitern eines Formularbereichs mit einem Add-In.

    Insbesondere zum Angeben benutzerdefinierter Symbole implementiert das Add-In die Methoden GetFormRegionManifest und GetFormRegionIcon der FormRegionStartup-Schnittstelle , wobei eine XML-Datei des Formularbereichmanifests und die Umstände angegeben werden, unter denen Outlook benutzerdefinierte Symbole im Explorer, Inspektor oder Menüband anzeigen soll. So können sie beispielsweise einen Formularbereich zum Anzeigen eines Aufgabentyps erstellen, der nur im Haushalt auftritt, wobei diese Haushaltsaufgaben der Nachrichtenklasse IPM.Task.Household angehören, die von IPM.Task abgeleitet ist. Sie können den Formularbereich mit einem Add-In erweitern, von dem in der GetFormRegionIcon -Methode ein besonderes Seriensymbol angegeben wird, das von Outlook neben Serienhaushaltsaufgaben im Explorer angezeigt werden soll.

  2. Geben Sie in der XML-Datei des Formularbereichmanifests unter dem Symbolelement den Wert addin für jedes untergeordnete Element an, in dem Sie ein benutzerdefiniertes Symbol verwenden möchten.

    Wenn Outlook Elemente im Explorer oder Inspektor anzeigt, sucht Outlook im Cache nach den Formularbereichmanifesten, die Elementen bestimmter Nachrichtenklassen zugeordnet sind. Wenn ein untergeordnetes Element des Symbols-Elements den Wert addinaufweist, ruft Outlook GetFormRegionIcon auf, um das entsprechende Symbol abzurufen, und zeigt es entsprechend für Elemente dieser Nachrichtenklasse an.

    Als Erweiterung des letzten Beispiels im Formularbereichmanifestdatei für den Formularbereich, der IPM zugeordnet ist. Task.Household können Sie unter dem Symbolelement den Wert addin für das wiederkehrende untergeordnete Element angeben. Wenn Outlook alle Aufgaben im Explorer anzeigt, betrachtet Outlook das zwischengespeicherte Formularbereichsmanifest nach Elementen, die zu IPM gehören. Task.Household. Wenn Outlook erkennt, dass das wiederkehrende Element den Wert addinhat, ruft Outlook GetFormRegionIcon auf, um das Symbol für wiederkehrende Haushaltsaufgaben zu erhalten, und zeigt im Explorer das spezielle wiederkehrende Symbol neben dieser Art von Aufgabe an. Weitere Informationen zu untergeordneten Elementen des Symbols-Elements finden Sie unter Vorgehensweise: Angeben von Symbolen, die für einen Formularbereich angezeigt werden sollen.

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.