Using Scripts to Manage Project's Interface Options

  • Article

Sample VBScript scripts that demonstrate how you can both retrieve and configure the Microsoft Project 2003 Interface options.

Mapping the Dialog Box to the Project Object Model

The options referenced in the following scripts correspond to the options found on the Interface tab of the Options dialog box. To access these options in Microsoft Project 2003, click Tools, click Options, and then click the Interface tab. A mapping between the options available in this dialog box and the Microsoft Project object model is shown below.

Interface

Note that the items shown in orange do not have a corresponding property in the Project object model. The current value for these items cannot be returned using the script for retrieving property values; however, the values can be configured using the OptionsInterface method. A sample script using OptionsInterface is included on this page.

The scripts shown on this page were tested using Microsoft Project 2003. At least some of the functionality is likely to work on any version of Microsoft Project that supports Visual Basic for Applications (VBA); however, the scripts have not been tested using any of these other versions.

Sample Code for Retrieving Values

Sample script that retrieves the configuration information found on the Interface tab in the Options dialog box in Microsoft Project 2003.

Set objProject = CreateObject("MSProject.Application")

Set colProjects = objProject.Projects
Set objDoc = colProjects.Add()

Wscript.Echo "Display Project Guide: " & objProject.DisplayProjectGuide
Wscript.Echo "Project Guide functionality and layout page: " & _
    objDoc.ProjectGuideUseDefaultFunctionalLayoutPage
Wscript.Echo "Project Guide content: " & objDoc.ProjectGuideUseDefaultContent

objProject.Quit

Sample Code for Modifying Values

Sample script that disables the option Display Project Guide.

Set objProject = CreateObject("MSProject.Application")

Set colProjects = objProject.Projects
Set objDoc = colProjects.Add()

objProject.DisplayProjectGuide = FALSE

objProject.Quit

Sample Code for Modifying Values Without Corresponding Properties

Sample script that disables the following four Microsoft Project options (in order):

  • Resource assignments

  • Edits to start and finish dates

  • Edits to work, units or duration

  • Deletions in the Name column

Set objProject = CreateObject("MSProject.Application")

Set colProjects = objProject.Projects
Set objDoc = colProjects.Add()

errReturn = objProject.OptionsInterface(FALSE,FALSE,FALSE,FALSE) 

objProject.Quit(pjDoNotSave)

The sample scripts are not supported under any Microsoft standard support program or service. The sample scripts are provided AS IS without warranty of any kind. Microsoft further disclaims all implied warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the sample scripts and documentation remains with you. In no event shall Microsoft, its authors, or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the sample scripts or documentation, even if Microsoft has been advised of the possibility of such damages.