Professional Documents
Culture Documents
By William Sengdara
Introduction
Yes, I know that this document should have been posted on a programming forum but I strongly believe that it
will help out some of the writers who submit their little works to Scribd.com and have no time for such forums.
If you work with Adobe PDF documents, you would by now have noticed that the program is able to
read the documents out loud – using the text-to-speech libraries installed on the computer.
Now, the way I do it is that whenever I write a novel, I will print it to a PDF printer and then have
Acrobat Reader read it out loud so that I am able to spot the numerous grammatical mistakes I am
naturally prone to make. As you can imagine, this compose-then-print-then-read cycle is an extreme waste
of time, as well as years spent as a freelance programmer.
Eventually though, I decided to investigate how to make things easier for myself. Comfort – not necessity,
is the mother of invention. Since I’ve worked with text-to-speech numerous times before, the only
problem I envisaged was with the MS Word Document Object Model. The help files that come with
Word helped with that!
So now, I have written a macro in MS Word to read the documents straight from within the program and
hopefully, some of you will give this tutorial a read-through.
This tip may work with previous versions of MS Word, but I have not bothered to check that out.
Creating the MS Word text-to-speech macro
1. Open MS Word 2007. Starts with a blank document. Now type in a few lines for testing purposes.
2. On the toolbar, locate and click the View menu, then click Macros.
3. A submenu will pop down as shown below
4.
10. Now select our new macro ReadOutLoudStarter in the list and click the button on the right named Edit.
11. The Visual Basic for Applications (VBA) editor will now open and allow you to edit the macro.
12. Inside the macro, just add the following lines of code
readOutLoud.show vbModal
12. Look for a folder in the list on your left named Forms, right-click it as shown in the image below and click
Insert -> UserForm.
13. A UserForm will now be added to the forms folder. You must now rename the form to ReadOutLoud and add
one command button from the ToolBox as show below and name it cmdClose. Change its caption to Done
Reading. If desired, you may add the label shown also and just type in The current selected text will now be read
by Speech API.
14. Double-click the button really fast so that the VBA code editor will open inside the button’s subroutine. Inside
the cmdClose_Click, type:
Unload Me
15. Now we need to add the Speech library reference, so on the menu, click Tools -> References as shown below.
16. The References dialog box will be shown. Scroll all the way to the bottom and search for and tick off the
Microsoft Speech Object Library
17. Now that we have the required reference, we must complete the code. Make sure your code is similar to the
code below:
Option Explicit
End Sub
18. Good job! Now close the VBA editor so that you are returned to the MS Word document with your few lines.
One last thing is to create an icon for the macro so that we can call it up any time we need it.
19. Click the large round MS Word button, and then click Word Options.
20. In the Options below, click Customize, click the Choose commands from drop down and click Macros.
21. Select the macro we created named Normal.NewMacros.ReadOutLoud. Click the Add >> button to move it to
the right list.
22. Now click once the macro and click the Modify button, in order for us to choose an icon and rename the
macro to a shorter name.
23. The modify button window will now open up. I selected the smiley face icon. Then I changed the display name
value to something much shorter, ReadOutLoudStarter.
24. Click OK to accept the changes.
25. If you have followed through correctly, the top of your MS Word toolbar should now look something like this,
with our macro icon ready for action.