KB189297 - WD2000: Sample VBA Code to Delete Built-In Style

Article ID: 189297

Article Last Modified on 10/11/2006

Microsoft Word 2000 Standard Edition

This article was previously published under Q189297

SUMMARY

This article describes how to delete built-in styles using Microsoft Visual Basic for Applications.

MORE INFORMATION

When you delete a built-in style, the style is removed from the list of styles currently being used in the document. Every range within the document receives the Normal style formatting after the built-in style is removed.

The following built-in styles cannot be deleted from a document:

Heading Styles 1-9
Normal Style (paragraph)
Normal Style (character)
Any style that has not been applied to a range within a document

If you attempt to delete one of these styles, the following error message appears:

Run-time error '5122': Style name does not exist

To avoid receiving the error message when you delete a built-in style, you must first verify that the style has been used in the document.

The following sample Visual Basic for Applications macro determines whether the built-in style Body Text Indent is being used in the document. If the style is used, the macro removes the style.

Sub DeleteBuiltInStyle()
   Dim odocStyle As Styles
   Set odocStyle = ActiveDocument.Styles
   If odocStyle(wdStyleBodyTextIndent).InUse Then
      odocStyle(wdStyleBodyTextIndent).Delete
   End If
End Sub

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. For additional information about getting help with Visual Basic for Applications, please see the following article in the Microsoft Knowledge Base:

226118 OFF20000: Programming Resources for Visual Basic for Applications

Additional query words: vb vbe vba

Keywords: kbdtacode kbhowto kbprogramming KB189297