FirstLetterExceptions Collection Object

  • Article
Word Developer Reference

A collection of FirstLetterException objects that represent the abbreviations excluded from automatic correction.

Remarks

The first character following a period is automatically capitalized when the CorrectSentenceCaps property is set to True. The FirstLetterExceptions collection includes exceptions to this behavior (for example, abbreviations such as "addr." and "apt.").

Use the FirstLetterExceptions property to return the FirstLetterExceptions collection. The following example deletes the abbreviation "addr." if it is included in the FirstLetterExceptions collection.

Visual Basic for Applications 
  For Each aExcept In AutoCorrect.FirstLetterExceptions
    If aExcept.Name = "addr." Then aExcept.Delete
Next aExcept

The following example creates a new document and inserts all the AutoCorrect first-letter exceptions into it.

Visual Basic for Applications 
  Documents.Add
For Each aExcept In AutoCorrect.FirstLetterExceptions
    With Selection
        .InsertAfter aExcept.Name
        .InsertParagraphAfter
        .Collapse Direction:=wdCollapseEnd
    End With
Next aExcept

Use the Add method to add an abbreviation to the list of first-letter exceptions. The following example adds the abbreviation "addr." to this list.

Visual Basic for Applications 
  AutoCorrect.FirstLetterExceptions.Add Name:="addr."

Use FirstLetterExceptions(Index), where Index is the abbreviation or the index number, to return a single FirstLetterException object. The following example deletes the abbreviation "appt." from the FirstLetterExceptions collection.

Visual Basic for Applications 
  AutoCorrect.FirstLetterExceptions("appt.").Delete

The following example displays the name of the first item in the FirstLetterExceptions collection.

Visual Basic for Applications 
  MsgBox AutoCorrect.FirstLetterExceptions(1).Name

See Also