MailMergeFields.AddFillIn Method (Word)
Adds a FILLIN field to a mail merge main document. Returns a MailMergeField object.
Syntax
expression .AddFillIn(Range, Prompt, DefaultFillInText, AskOnce)
expression Required. A variable that represents a MailMergeFields collection.
Parameters
Name |
Required/Optional |
Data Type |
Description |
---|---|---|---|
Range |
Required |
Range object |
The location for the FILLIN field. |
Prompt |
Optional |
Variant |
The text that's displayed in the dialog box. |
DefaultFillinText |
Optional |
Variant |
The default response, which appears in the text box when the dialog box is displayed. Corresponds to the \d switch for an FILLIN field. |
AskOnce |
Optional |
Variant |
True to display the prompt only once instead of each time a new record is merged. Corresponds to the \o switch for a FILLIN field. The default value is False. |
Return Value
MailMergeField
Remarks
When updated, a FILLIN field displays a dialog box that prompts you for text to insert into the document at the location of the FILLIN field. Use the Add method with the Fields collection object to add a FILLIN field to a document other than a mail merge main document.
Example
This example adds a FILLIN field that prompts you for a name to insert after "Name:".
With Selection
.Collapse Direction:=wdCollapseStart
.InsertAfter "Name: "
.Collapse Direction:=wdCollapseEnd
End With
ActiveDocument.MailMerge.Fields.AddFillin Range:=Selection.Range, _
Prompt:="Your name?", DefaultFillInText:="Joe", AskOnce:=True