Written by Allen Wyatt (last updated February 20, 2020)
This tip applies to Word 97, 2000, 2002, and 2003
One of the most common things you need to do when creating a macro is to repeat a block of actions for each occurrence of something within a file. This may sound strange, but those who program know the situation very well—you need to search through a file and then take some action, repeat the search and repeat the action, and so on until the end of the file is reached. The general approach is as follows:
Selection.HomeKey Unit:=wdStory [set up for your search] Selection.Find.Execute While Selection.Find.Found [take some action] Selection.Find.Execute Wend
The first line in this example moves to the beginning of the document. You then use whatever commands necessary to set up for your search. When the Selection.Find.Execute line is encountered, Word performs the actual search. Then Selection.Find.Found is used to control the While ... Wend loop. This property (Selection.Find.Found) is set to True each time an executed search actually results in something being found. Thus, the whole While ... Wend loop is repeated over and over again, as long as whatever you are searching for continues to be found. As the last step in the loop, the Selection.Find.Execute statement is used to once again perform the search.
Note:
WordTips is your source for cost-effective Microsoft Word training. (Microsoft Word is the most popular word processing software in the world.) This tip (1083) 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: Repeating In a Macro.
Do More in Less Time! An easy-to-understand guide to the more advanced features available in the Microsoft 365 version of Word. Enhance the quality of your documents and boost productivity in any field with this in-depth resource. Complete your Word-related tasks more efficiently as you unlock lesser-known tools and learn to quickly access the features you need. Check out Microsoft 365 Word For Professionals For Dummies today!
Need to save a new document, from within a macro, to a specific file name? If you use the Record Macro capabilities of ...
Discover MoreYou may need to determine the numeric value of a character in a macro. You can do that using the Asc function, described ...
Discover MoreWhen writing a macro to process the text in a document, you may need to move the insertion point to the end of a line. ...
Discover MoreFREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."
2015-05-13 12:12:47
Dawn
What goes in the "take some action" section in your example?
2015-03-29 00:05:57
Redeer
I currently have a macro like this that goes character by character (i.e. slowly). It is changing the color of the character if the Selection.Find.Found color is not blue.
Is there any way to have it iterate through the whole document paragraph by paragraph or sentence by sentence?
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.
Visit the WordTips channel on YouTube
FREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."
Copyright © 2025 Sharon Parq Associates, Inc.
Comments