OFF97: How to Run Sample Code from Knowledge Base Articles

• Microsoft Word 97 for Windows
• Microsoft PowerPoint 97 for Windows
• Microsoft Excel 97 for Windows

SUMMARY

The Microsoft Knowledge Base contains a number of articles that contain sample code for Visual Basic for Applications macros. Many of these macros illustrate basic concepts of programming in Visual Basic for Microsoft Office. This article contains instructions on how to use the sample code to create a new macro, and how to run that macro.

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and 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 needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/supportnet/refguide/

To Create a New Macro

1. Open or create an Excel workbook, PowerPoint presentation or Word template or document as appropriate.

2. On the Tools menu, point to Macro, and then click Macros.

3. In the Macros In list, click the Excel workbook, PowerPoint presentation or Word template or document where you want to save the macro.

4. In the Macro Name box, type a name for the macro.

5. Click Create to open the Visual Basic Editor.

6. Type the macro code between the first line

         Sub <macro name>()
   
      and the last line:
   
         End Sub
   
      To add the sample code to the macro using the Clipboard, follow these
      steps:
   
       a Switch to the program that you are using to view the Knowledge Base
         article, such as Microsoft Internet Explorer.
   
       b. Select only the sample code between the first line, "Sub <macro
          name>()" and the last line, "End Sub."
   
       c. On the Edit menu, click Copy.
   
       d. Switch to the Visual Basic Editor.
   
       e. In the Visual Basic Editor, click to place the insertion point
          between the first line, "Sub <macro name>()" and the last line, "End
          Sub" of your macro.
   
       f. On the Edit menu, click Paste.
   
   

To Add the Sample Code to a Module

To add code to a module, you must either have an existing module or create a new module. To do this, follow these steps:

1. Open or create an Excel workbook, PowerPoint presentation or Word template or document as appropriate.

2. On the Tools menu, point to Macro and then click Visual Basic Editor.

3. In the Project window of the Visual Basic Editor (by default this is in the upper left corner), click the project icon with the same name as your workbook, presentation, template, or document. If you haven't yet saved your workbook, presentation, template or document, the project name is based on the program that you are using.

         Program                Default project name
         -------------------------------------------
   
         Microsoft Excel        VBAProject(Book1)
   
         Microsoft PowerPoint   VBAProject(Presentation1)
   
         Microsoft Word         Project(Document1)
                                -or-
                                TemplateProject(Template1)
   
      NOTE: If you want to store your macro in the default Microsoft
      Word template, Normal.dot, double-click the Normal project.
   
   

4. If the project you clicked does not contain a folder called Modules underneath it, click Module on the Insert menu.

5. Click anywhere in the code window of the module you want to create. The code window is usually in the upper right corner of the Visual Basic Editor.

6. Type the sample code exactly as it appears in the Knowledge Base article, including the "Sub <macro name>()" and "End Sub" lines. Use the TAB key to indent text.

   NOTE: Lines that begin with an apostrophe (') are comments and are not required to run the macro. However, you may want to type them in to make it easier to understand the macro.

To Run the Macro

1. Switch from the Visual Basic Editor to Excel, PowerPoint or Word as appropriate.

2. On the Tools menu, point to Macro and then click Macros.

3. Click the name of the macro on the Macro Name list and then click Run.

REFERENCES

Microsoft Help for each Office program contains numerous topics about working with macros. Visual Basic help contains extensive information about writing your own code.

For additional information about getting help with Visual Basic for Applications, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q163435
   TITLE : VBA: Programming Resources for Visual Basic for Applications