Share via


MailMergeFields.AddSet Method (Word)

Adds a SET field to a mail merge main document. Returns a MailMergeField object.

Syntax

expression .AddSet(Range, Name, ValueText, ValueAutoText)

expression Required. A variable that represents a MailMergeFields collection.

Parameters

Name

Required/Optional

Data Type

Description

Range

Required

Range object

The location for the SET field.

Name

Required

String

The bookmark name that ValueText is assigned to.

ValueText

Optional

Variant

The text associated with the bookmark specified by the Name argument.

ValueAutoText

Optional

Variant

The AutoText entry that includes text associated with the bookmark specified by the Name argument. If this argument is specified, ValueText is ignored.

Return Value

MailMergeField

Remarks

A SET field defines the text of the specified bookmark.

Example

This example adds a SET field at the beginning of the active document and then adds a REF field to display the text after the selection.

Dim rngTemp as Range 
 
Set rngTemp = ActiveDocument.Range(Start:=0, End:=0) 
 
ActiveDocument.MailMerge.Fields.AddSet Range:=rngTemp, _ 
 Name:="Name", ValueText:="Joe Smith" 
Selection.Collapse Direction:=wdCollapseEnd 
ActiveDocument.Fields.Add Range:=Selection.Range, _ 
 Type:=wdFieldRef, Text:="Name"

See Also

Concepts

MailMergeFields Collection Object

MailMergeFields Object Members