WD97: Macro to Create Table of Contents Entry Automatically

Last reviewed: March 17, 1998
Article ID: Q170612
The information in this article applies to:
  • Microsoft Word 97 for Windows

SUMMARY

The following macro example allows you to designate selected text as a table of contents entry without removing the text from the body of the document and without having to type the table of contents entry twice.

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/support/supportnet/refguide/default.asp

You can assign the following macro to a menu, toolbar, or key sequence to quickly designate text to be included in a table of contents.

   Sub EnterTCField()
      Dim SelectedText As String
      ' Selection must be text.
      If Selection.Type = wdSelectionNormal Then
         ' Get selected text and place it within quotation marks.
         SelectedText = Chr$(34) & Selection.Text & Chr$(34)
         ' Move insertion point to end of selection.
         Selection.Collapse (wdCollapseEnd)
         ' Insert TC field.
         Selection.Fields.Add Range:=Selection.Range, _
         Type:=wdFieldTOCEntry, Text:=SelectedText
      Else
         MsgBox "The selected text is not valid for a TC field."
      End If
   End Sub

When you have designated all of the table of contents entries with this macro, choose Table Of Contents from the Insert menu. Click Options and click to select the Table entry fields check box.

Table of Contents entries or TC fields are automatically formatted as hidden text. To edit these entries, you must select either Show All or Hidden Text. To do this, do the following:

  1. On the Tools menu, click Options.

  2. On the View tab, click to select Field Codes.

  3. Click to select the Hidden Text check box.

For more information about Table of Contents Entry fields, click Contents And Index on the Help menu, click the Index tab in Word Help, type the following text

   TC

and then double-click the selected text to go to the "Field codes: TC (Table of Contents Entry) field" topic. If you are unable to find the information you need, ask the Office Assistant.

For more information about adding a command to a menu, click Contents And Index on the Help menu, click the Index tab in Word Help, type the following text

   menus, commands

and then double-click the selected text to go to the "Add a command or other item to a menu" topic. If you are unable to find the information you need, ask the Office Assistant.

For additional information, please see the following articles in the Microsoft Knowledge Base:

   ARTICLE-ID: Q70996
   TITLE     : WD: Macro to Create Table of Contents Entry Automatically

   ARTICLE-ID: Q163547
   TITLE     : WD97: How to Create Custom Toolbars and Toolbar Buttons

   ARTICLE-ID: Q173707
   TITLE     : OFF97: How to Run Sample Code from Knowledge Base Articles

REFERENCES

For more 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


Additional query words: vb vba vbe
Keywords : kbwordvba word8 word97 kbdta kbdtacode
Version : 97
Platform : WINDOWS
Issue type : kbhowto


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: March 17, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.