AddFillIn Method

Microsoft Word Visual Basic

AddFillIn Method

       

Adds a FILLIN field to a mail merge main document. Returns a MailMergeField object. 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.

Note   Use the Add method with the Fields collection object to add a FILLIN field to a document other than a mail merge main document.

expression.AddFillIn(Range, Prompt, DefaultFillInText, AskOnce)

expression   Required. An expression that returns a MailMergeFields object.

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 data record is merged. Corresponds to the \o switch for a FILLIN field. The default value is False.

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