WD: How to Use the MACROBUTTON Field in WinWord Documents

• Microsoft Word for Windows versions 1.0, 1.1, 1.1a, 2.0, 2.0a, 2.0a-CD, 2.0b, 2.0c, 6.0, 6.0a, 6.0c
• Microsoft Word for Windows 95, versions 7.0, 7.0a
• Microsoft Word 97 for Windows

SUMMARY

With the MACROBUTTON field in Microsoft Word for Windows, you can create a button in your document that invokes a macro when you double- click it. The syntax of this field is as follows

   {MACROBUTTON macroName buttonText}

When you display the result of the MACROBUTTON field, either the text or graphic that you specified as the buttonText instruction is displayed. Word automatically updates the field's result whenever you edit the field. If you have a mouse, double-click the text or graphic returned by the MACROBUTTON field to run the macro specified in the field's macroName argument. If you don't have a mouse, use the keyboard to select the text or graphic returned by the MACROBUTTON field, and press ALT+SHIFT+F9 to run the specified macro.

MORE INFORMATION

There are two ways to use a graphic (instead of text) to represent the button. The first is to use a separate graphic file, and the second is to include the graphic directly in the document.

Method 1

To use a separate graphic file, in Word version 6.0, the syntax is as follows:

{MACROBUTTON macroName {includepicture c:\\directory\\subdirectory\\file}}

The IMPORT or INCLUDEPICTURE field code is a field code you insert within the MACROBUTTON field telling the program to insert the referenced graphic file. The advantage of this method is that the graphic does not increase the size of your document.

To use a separate graphic file, the field code syntax is as follows for Word versions 1.0 and 2.0:

 {MACROBUTTON macroName {import c:\\directory\\subdirectory\\file}}

Method 2

You can also insert the button graphic directly into your document:

1. Copy the graphic you intend to use as the button to the Clipboard. (You could do this by temporarily placing the graphic somewhere in your document and Cutting it to the Clipboard.)

2. Create a MACROBUTTON field.

3. Place the insertion point in the MACROBUTTON field where the buttonText instruction should appear.

4. On the Edit menu, choose Paste Special and select Picture to insert the graphic as the button.

REFERENCES

"Word for Windows Companion, Second Edition," pages 555-58

"Word 6 for Windows Companion," pages 707-710