Application.OptionsPagesAdd Event (Outlook)
Occurs whenever the user clicks the Add-in Options button on the Add-ins tab of the Outlook Options dialog box.
Syntax
expression .OptionsPagesAdd(Pages, Folder)
expression A variable that represents an Application object.
Parameters
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
Pages |
Required |
The collection of property pages that have been added to the dialog box. This collection includes only custom property pages. It does not include standard Microsoft Outlook property pages. |
|
Folder |
Required |
PropertyPages |
This argument is only used with the Folder object. The Folder object for which the Properties dialog box is being opened. |
Remarks
This event is not available in Microsoft Visual Basic Scripting Edition (VBScript).
Your program handles this event to add a custom property page. The property page will be added to the Options dialog box. When the event fires, the PropertyPages collection object identified by Pages contains the property pages that have been added prior to the event handler being called. To add your property page to the collection, use the Add method of the PropertyPages collection before exiting the event handler.
Example
This Microsoft Visual Basic for Applications (VBA) example adds a new property page to the Outlook Options dialog box. The sample code must be placed in a class module of a Component Object Model (COM) add-in. For information about COM add-ins, see Customizing Outlook using COM add-ins.
Implements IDTExtensibility2
Private WithEvents OutlApp As Outlook.Application
Private Sub IDTExtensibility2_OnConnection(ByVal Application As Object, ByVal ConnectMode As AddInDesignerObjects.ext_ConnectMode, ByVal AddInInst As Object, custom() As Variant)
Set OutlApp = Outlook.Application
End Sub
Private Sub OutlApp_OptionsPagesAdd(ByVal Pages As Outlook.PropertyPages)
Pages.Add "PPE.SimplePage", "Simple Page"
'PPE.SimplePage is a ProgID of the registered ActiveX Control - the property page that is to be displayed in the COM add-in
End Sub