Repeating in a WordBasic Macro

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.

If you are using WordBasic (Word 6 or Word 95), the general approach is as follows:

StartOfDocument
[search for something]
While EditFindFound()
    [take some action]
    [repeat the search]
Wend

The first line moves the insertion point to the beginning of the document, where you can begin your search. After the search you use a While ... Wend loop with the EditFindFound() function. This function returns a True value if the last search was positive, or False if nothing was found. Once inside the While ... Wend loop you can then take any action desired. As the last step within the While ... Wend loop, simply repeat your search and the loop will run until Word can no longer find what you are looking for.