Function Reference

_OL_ViewModify

Modifies properties of a view.

#Include <OutlookEX_GUI.au3>
_OL_ViewModify($oOL, $vView, [$vFolder = Default[, $sName = Default[, $bLockUserChanges = Default[, $sFilter = Default[, $sXML = Default]]]]])

 

Parameters

$oOL Outlook object returned by a preceding call to _OL_Open()
$vView Index, name or object of the view to be modified
$vFolder [optional] Folder object as returned by _OL_FolderAccess or full name of folder. Has to be specified when $vView is not a view object
$sName [optional] Display name for the view (default = do not modify)
$sLanguage [optional] String that represents the language setting for the object that defines the language used in the menu (default = do not modify)
$bLockUserChanges [optional] Indicates whether a user can modify the settings of the current view. Use True or False (default = do not modify)
$sFilter [optional] String in DAV Searching and Locating (DASL) syntax that represents the current filter for the view (default = do not modify)
$sXML [optional] String value that specifies the XML definition of the current view (default = do not modify)

 

Return Value

Success: Object of the view
Failure: Returns 0 and sets @error:
    1 - $vFolder has not been specified
    2 - Error accessing the specified folder. See @extended for errorcode returned by GetFolderFromID
    3 - Error accessing the folders views. @extended is set to the COM error code
    4 - View does not exist or an error occurred. @extended is set to the COM error code (if any)
    5 - Error modifying property "Name". @extended is set to the COM error code
    6 - Error modifying property "Language". @extended is set to the COM error code
    7 - Error modifying property "LockUserChanges". @extended is set to the COM error code
    8 - Error modifying property "Filter". @extended is set to the COM error code
    9 - Error modifying property "XML". @extended is set to the COM error code
    10 - Error saving the new view. @extended is set to the COM error code

 

Remarks

$sLanguage: Example: "EN-US" represents the ISO code for "United States - English"

 

Related