Share via


Folder.CustomViewsOnly Property

Outlook Developer Reference

Returns or sets a Boolean that determines which views are displayed on the View menu for a given folder. Read/write.

Version Information
 Version Added:  Outlook 2007

Syntax

expression.CustomViewsOnly

expression   A variable that represents a Folder object.

Remarks

If set to the True, only user-created views will appear on the menu.

This property has an effect only on the View menu. It does not affect the display of views in the Navigation Pane.

Example

The following example prompts the user to select a view option. If the user chooses to view all views, the CustomViewsOnly property is set to False. If the user chooses to view only custom views, the CustomViewsOnly property is set to True. Once the property is changed, the outcome of the change can be seen in the user interface.

Visual Basic for Applications
  Sub SetCusView()
    'Sets the CustomViewsOnly property depending on the user's response
    Dim nmsName As Outlook.NameSpace
    Dim fldFolder As Outlook.Folder
    Dim lngAns As Long
Set nmsName = Application.GetNamespace("MAPI")
Set fldFolder = nmsName.GetDefaultFolder(olFolderInbox)
'Prompt user for input
lngAns = MsgBox( _
    "Would you like to view only custom views in the View menu?", vbYesNo)
Call SetVal(fldFolder, lngAns)

End Sub

Sub SetVal(ByRef fldFolder As Folder, ByVal lngAns As Long) 'Modifies the CustomViewsOnly property to display views on the View menu If lngAns = vbYes Then fldFolder.CustomViewsOnly = True Else fldFolder.CustomViewsOnly = False End If 'Display only custom views If lngAns = vbYes Then MsgBox "The View menu for the " _ & fldFolder.Name & " folder will now display only custom views." 'Display all views Else MsgBox "The View menu for the " _ & fldFolder.Name & " folder will now display all views." End If End Sub

See Also