Using Scripts to Manage Word's Spelling and Grammar Options

  • Article

Sample VBScript scripts that demonstrate how you can both retrieve and configure the Microsoft Word 2003 Spelling and Grammar options.

Mapping the Dialog Box to the Word Object Model

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

Spelling and Grammar

The scripts shown on this page were tested using Microsoft Word 2003. At least some of the functionality is likely to work on any version of Microsoft Word 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 Spelling and Grammar tab of the Options dialog box in Microsoft Word 2003.

On Error Resume Next

Set objWord = CreateObject("Word.Application")
Set objOptions = objWord.Options
Set objDoc = objWord.Documents.Add()

Wscript.Echo "Check spelling as you type: " & _
    objOptions.CheckSpellingAsYouType
Wscript.Echo "Ignore words in uppercase: " & _
    objOptions.IgnoreUppercase
Wscript.Echo "Ignore words with numbers: " & _
    objOptions.IgnoreMixedDigits
Wscript.Echo "Ignore Internet and file addresses: " & _
    objOptions.IgnoreInternetAndFileAddresses
Wscript.Echo "Check grammar as you type: " & _
    objOptions.CheckGrammarAsYouType
Wscript.Echo "Check grammar with spelling: " & _
    objOptions.CheckGrammarWithSpelling
Wscript.Echo "Always suggest corrections: " & _
    objOptions.SuggestSpellingCorrections
Wscript.Echo "Suggest from main dictionary only: " & _
    objOptions.SuggestFromMainDictionaryOnly
Wscript.Echo "Show readability statistics: " & _
    objOptions.ShowReadabilityStatistics
Wscript.Echo "Hide spelling errors in this document: " & _
    objDoc.ShowSpellingErrors
Wscript.Echo "Hide grammatical errors in this document: " & _
    objDoc.ShowGrammaticalErrors

objWord.Quit

Sample Code for Modifying Values

Sample script that sets the Check spelling as you type option in Microsoft Word to FALSE.

On Error Resume Next

Set objWord = CreateObject("Word.Application")
Set objOptions = objWord.Options
objOptions.CheckSpellingAsYouType = FALSE

objWord.Quit

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.