Please Note: This article is written for users of the following Microsoft Word versions: 97, 2000, 2002, and 2003. If you are using a later version (Word 2007 or later), this tip may not work for you. For a version of this tip written specifically for later versions of Word, click here: Cleaning Up Text in a Macro.
by Allen Wyatt
(last updated February 15, 2014)
There have been many macros that I have written with the express purpose of "cleaning up" text prior to doing something else with it. For instance, inserting it in a new document or saving it in a text file. Often this process is tedious, involving examining each character in a text string and then making some decision as to what to do with it if the character is not within a range of acceptable characters.
VBA includes an interesting method that can be used to help clean up text. It is called, appropriately enough, the CleanString method. You use it as shown here:
sCleanedUp = Application.CleanString(Selection.Text)
This instance sets the sCleanedUp string equal to a "cleaned up" version of the selected text. What exactly does the CleanString method do? It removes non-printing characters in the ANSI range of 1 through 29, with the exception of 7, 9, 10, and 13. In the case of ANSI character 7, it is removed unless it is preceded by character 13, in which case it is replaced with a tab (ANSI 9). In the case of ANSI character 10, it is replaced with character 13 unless preceded by character 13, in which case it is removed. Characters 9 and 13 are not changed.
A number of other characters outside the range of 1 through 29 are also affected by the CleanString method. ANSI character 31 (the optional hyphen), character 172 (also an optional hyphen), and character 182 (the paragraph mark character) are all removed. ANSI character 160 (the non-breaking space), character 176 (another non-breaking space), and character 183 (a bullet character) are each replaced with spaces. All other characters are unchanged.
WordTips is your source for cost-effective Microsoft Word training. (Microsoft Word is the most popular word processing software in the world.) This tip (1460) applies to Microsoft Word 97, 2000, 2002, and 2003. You can find a version of this tip for the ribbon interface of Word (Word 2007 and later) here: Cleaning Up Text in a Macro.
Create Custom Apps with VBA! Discover how to extend the capabilities of Office 2013 (Word, Excel, PowerPoint, Outlook, and Access) with VBA programming, using it for writing macros, automating Office applications, and creating custom applications. Check out Mastering VBA for Office 2013 today!
For certain types of writing, you may want to make sure that the sentences in your document do not exceed a certain ...Discover More
When you are printing a document, it is not unusual to see messages (dialog boxes) periodically. When you want the ...Discover More
One of the common things done in macros is to somehow "process" documents, which often means moving the insertion point ...Discover More
FREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."
Got a version of Word that uses the menu interface (Word 97, Word 2000, Word 2002, or Word 2003)? This site is for you! If you use a later version of Word, visit our WordTips site focusing on the ribbon interface.