WD2000: How to Store and Retrieve Variables in Documents

ID: Q209227

The information in this article applies to:

Microsoft Word 2000

SUMMARY

This article describes how to set and retrieve document variables using Microsoft Word.

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 professionals 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 a Microsoft Certified Solution Provider or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Solution Providers, please see the following page on the World Wide Web:

http://www.microsoft.com/mcsp/

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/overview/overview.asp

For more information about using the sample code in this article, click the article number below to view the article in the Microsoft Knowledge Base:

Q212536 OFF2000: How to Run Sample Code from Knowledge Base Articles

You can use the Microsoft Visual Basic for Applications Variables collection to set and retrieve the contents of a string variable into a Word document or template.

Also, you can use the DocVariable field to retrieve the value of a document variable after it has been set.

To Set and Retrieve the Value of a Document Variable

The following sample macro uses the Variables property to store and then retrieve the value of a string variable named "FullName" with the current document.


Sub GetSetDocVars()

   Dim fName As String
   fName = "Jeff Smith"
   ' Set contents of variable "fName" in a document using a document
   ' variable called "FullName".
   ActiveDocument.Variables.Add Name:="FullName", Value:=fName
   ' Retrieve the contents of the document variable.
   MsgBox ActiveDocument.Variables("FullName").Value

End Sub

To Delete a Document Variable

The following sample macro uses the Variables property to first set and retrieve the value of a document variable and then delete the variable from the active document.


Sub GetSetDeleteDocVars()

   Dim fName As String
   fName = "Jeff Smith"
   ' Set contents of variable "fName" in a document using a document
   ' variable called "FullName."
   ActiveDocument.Variables.Add Name:="FullName", Value:=fName
   ' Retrieve the contents of the document variable.
   MsgBox ActiveDocument.Variables("FullName").Value
   ' Delete the variable.
   ActiveDocument.Variables("FullName").Delete

End Sub

To Retrieve the Value of a Document Variable Using the DocVariable Field

The following sample macro uses the Variables property to set a document variable. Following the sample macro are steps to use the DocVariable field to retrieve the value into the contents of the same document.


Sub GetSetDocVars()

   Dim fName As String
   fName = "Jeff Smith"
   ' Set contents of variable "fName" in a document using a document
   ' variable called "FullName."
   ActiveDocument.Variables.Add Name:="FullName", Value:=fName

End Sub

To use the DocVariable field, do the following:

On the Insert menu, click Field.

In the Categories list, click Document Automation.

In the Field Names list, click DocVariable.

Click in the Field codes box so that the insertion point is one space past the word DocVariable.

In quotation marks, type the name of the document variable.

Example: "FullName"

Click OK.

If you need to preserve a value between sessions of a macro, you can store values using any of the following methods:

Use the PrivateProfileString property to store values to a private settings file.

For more information about the PrivateProfileString property, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type PrivateProfileString Property in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

Use the Variables property to store values in a document.

For more information about the Variables property, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type Variables property in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

Use the Visual Basic for Applications Input/Output statements to write to a text file (for example, Write or Print statements).

For more information about writing data to files, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type Writing Data to Files in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

Use the AutoTextEntry object to store values in an AutoText entry. For more information about the AutoTextEntry object, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type AutoTextEntry object in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

REFERENCES

For additional information about getting help with Visual Basic for Applications, click the article numbers below to view the articles in the Microsoft Knowledge Base:

Q212623 WD2000: Macro Programming Resources

Q226118 OFF2000: Programming Resources for Visual Basic for Applications

Additional query words: vb vba vbe

Keywords : kbdta kbdtacode OffVBA wd2000
Version : WINDOWS:2000
Platform : WINDOWS
Issue type : kbhowto