FormRegionStartup.GetFormRegionIcon-Methode (Outlook)

Ruft eine Symbolgrafik ab, die für einen bestimmten Symboltyp eines Formularbereichs angezeigt wird.

Syntax

Ausdruck. GetFormRegionIcon( _FormRegionName_ , _LCID_ , _Icon_ )

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.
Icon	Erforderlich	OlFormRegionIcon	Eine Konstante, die den Symboltyp angibt.

Rückgabewert

Ein Variant-Wert, der entweder ein Bytearray, die der Bilddatei an die ursprüngliche Bytes darstellt, oder ein IPictureDisp -Objekt ist.

HinwBemerkungeneise

Diese Methode sollte durch ein Add-In implementiert und von Outlook aufgerufen werden. Als Teil der FormRegionStartup -Schnittstelle bieten diese und die GetFormRegionManifest -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 Symbole 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 und die GetFormRegionIcon -Methoden des FormRegionStartup -Schnittstelle implementieren.

Geben Sie in der XML-Manifestdatei für den Formularbereich, unter dem Icons -Element den Wert addin für jeden der untergeordneten Elemente, in dem Sie ein benutzerdefiniertes Symbol verwenden möchten. Implementieren Sie GetFormRegionIcon so, dass GetFormRegionIcon das Bild des benutzerdefinierten Symbols zurückgibt, wenn Outlook diesen Symboltyp als Argument für Icon übergibt. Wenn Outlook das Standardsymbol anzeigen soll, implementieren Sie GetFormRegionIcon so, dass die Methode für diesen Symboltyp null (Nothing in Visual Basic) zurückgibt. GetFormRegionIcon sollte auch null (Nothing in Visual Basic) zurückgeben, wenn Iconden Wert olFormRegionIconDefault aufweist.

Wenn Outlook startet, wird die Liste der Formularbereiche in der Windows-Registrierung gelesen und die den Formularbereichen zugeordneten Daten zwischengespeichert. Wenn ein Formularbereich mit einer ProgID registriert wurde, greift Outlook auf das entsprechende Add-In zurück, indem die Implementierung von GetFormRegionIcon für jedes Symbol im XML-Manifest aufgerufen wird, das den Wert eines untergeordneten Elements des Symbols-Elements aufweistaddin. Beachten Sie, dass Outlook die Methoden GetFormRegionManifest und GetFormRegionIcon nicht aufruft, wenn Sie in der Windows-Registrierung keine ProgID angeben.

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.