Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Zum Erstellen einer benutzerdefinierten Eigenschaftenseite für Microsoft Outlook sind die folgenden vier wesentlichen Schritte erforderlich:
Erstellen der Seite als ActiveX-Steuerelement.
Implementieren des PropertyPage -Objekts.
Schreiben einer Prozedur, mit der der Wert der Dirty -Eigenschaft festgelegt und die OnStatusChange -Methode aufgerufen wird.
Erstellen eines COM-Add-Ins (Component Object Model), das eine Ereignisprozedur für OptionsPagesAdd entweder für das Objekt Application oder für das Objekt NameSpace enthält. Informationen zum Erstellen eines COM-Add-Ins finden Sie unter Anpassen von Outlook mithilfe von COM-Add-Ins.
Erstellen der Seite als ActiveX-Steuerelement
Eine benutzerdefinierte Eigenschaftenseite in Outlook besteht aus einem ActiveX-Steuerelement, das zusammen mit einer als COM-Add-In entworfenen Dynamic Link Library (DLL) implementiert wird. Am einfachsten lassen sich benutzerdefinierte Eigenschaftenseiten mit Microsoft Visual Basic, Version 6.0 oder höher, erstellen. Diese Version von Visual Basic verfügt über Vorlagen und Funktionen, die das Erstellen von ActiveX-Steuerelementen und COM-Add-Ins vereinfachen.
Wenn Sie das ActiveX-Steuerelement erstellen, füllen Sie es mit den Steuerelementen auf, die ihr Benutzer benötigt, um die Eigenschaften festzulegen, die ihre Seite unterstützen soll. Da Outlook die Größe des Steuerelements ändern kann, wenn es die Eigenschaftenseite im Dialogfeld anzeigt, sollte das Initialize-Ereignis des Steuerelements die untergeordneten Steuerelemente dynamisch positionieren und skalieren, abhängig von den endgültigen Werten der Eigenschaften Breite und Höhe des Steuerelements.
In dem Dialogfeld, das die benutzerdefinierte Eigenschaftenseite anzeigt, befinden sich unterhalb der Eigenschaftenseiten drei Schaltflächen: die Schaltfläche OK, die Schaltfläche Abbrechen und die Schaltfläche Übernehmen. Durch Klicken auf die Schaltfläche OK werden die Änderungen für alle Seiten im Dialogfeld übernommen, und das Dialogfeld wird geschlossen. Durch Klicken auf die Schaltfläche Abbrechen werden keine Änderungen durchgeführt, und das Dialogfeld wird geschlossen. Durch Klicken auf die Schaltfläche Übernehmen werden die Änderungen der Eigenschaften übernommen, das Dialogfeld bleibt jedoch geöffnet. Sie sollten Ihre Eigenschaftenseite so gestalten, dass diese Schaltflächen entsprechend reagieren, wenn Benutzer darauf klicken. In späteren Abschnitten in diesem Thema erfahren Sie, wie Outlook davon benachrichtigt wird, dass der Status Ihrer Eigenschaftenseite sich geändert hat, und wie Ihr Programm von Outlook benachrichtigt wird, wenn die geänderten Eigenschaftswerte übernommen werden sollen.
Implementieren des PropertyPage-Objekts
Bei dem PropertyPage -Objekt handelt es sich um ein abstraktes Objekt, das heißt, seine Schnittstellen werden von Outlook zwar definiert, aber nicht implementiert. Wenn Ihre Änderung der benutzerdefinierten Eigenschaften von den Schaltflächen Übernehmen oder Hilfe des übergeordneten Dialogfelds abhängt, muss das PropertyPage -Objekt von dem Modul implementiert werden, das das ActiveX-Steuerelement der benutzerdefinierten Eigenschaftenseite enthält. Zur Implementierung des Objekts muss das Modul über einen Verweis auf die Outlook 9-Objektbibliothek verfügen und die folgende Anweisung enthalten.
Implements Outlook.PropertyPage
Das Modul muss außerdem über Code zur Implementierung der Methoden und Eigenschaften des PropertyPage -Objekts verfügen. Diese Prozeduren sind in der folgenden Tabelle beschrieben.
| Verfahren | Beschreibung |
|---|---|
| Dirty-Eigenschaft | Wird von Outlook als Reaktion auf die OnStatusChange-Methode aufgerufen, um festzustellen, ob der Benutzer einen Wert auf der Eigenschaftenseite geändert hat. |
| Apply-Methode | Wird von Outlook aufgerufen, um Ihrem Programm mitzuteilen, dass auf die Schaltflächen OK oder Übernehmen geklickt wurde. Diese Prozedur weist in der Regel alle Werte zu, die vom Benutzer auf der Eigenschaftenseite geändert wurden. |
| GetPageInfo-Methode | Wird von Outlook aufgerufen, um die mit der Eigenschaftenseite zusammenhängende Hilfedatei und das entsprechende Hilfethema zu erhalten. |
Schreiben einer Prozedur, mit der die Dirty-Eigenschaft festgelegt und die OnStatusChange-Methode aufgerufen wird
Most commonly, changes to property values are not applied immediately in response to user interaction with the controls that let the user specify those values. Instead, the values are applied when the user clicks OK or Apply in the dialog box. The Apply button is grayed until the user changes a value on a property page. To notify Outlook that the user has changed a value on your property page, your program should call the OnStatusChange method and then return True when Outlook queries the Dirty property.
Erstellen eines COM-Add-Ins, das eine Ereignisprozedur für das OptionsPagesAdd-Ereignis enthält
Durch das OptionsPagesAdd -Ereignis kann von Ihrem Programm Ihre benutzerdefinierte Eigenschaftenseite dem Dialogfeld Optionen in Microsoft Outlook hinzugefügt werden (falls das Ereignis für das Application -Objekt ausgelöst wurde) oder dem Dialogfeld Eigenschaften des Ordners (falls das Ereignis für das NameSpace -Objekt aufgerufen wurde). Wenn diese Ereignisprozedur von Outlook aufgerufen wird, wird ein PropertyPages -Objekt mit übergeben. Ihre Ereignisprozedur verwendet die Add -Methode der Auflistung, um das von Ihrem Programm implementierte PropertyPage -Objekt dem Objekt hinzuzufügen.
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.