Selection.InsertFile Method

  • Article
Word Developer Reference

Inserts all or part of the specified file.

Syntax

expression.InsertFile(FileName, Range, ConfirmConversions, Link, Attachment)

expression   Required. A variable that represents a Selection object.

Parameters

Name Required/Optional Data Type Description
FileName Required String The path and file name of the file to be inserted. If you don't specify a path, Word assumes the file is in the current folder.
Range Optional Variant If the specified file is a Word document, this parameter refers to a bookmark. If the file is another type (for example, a Microsoft Excel worksheet), this parameter refers to a named range or a cell range (for example, R1C1:R3C4).
ConfirmConversions Optional Variant True to have Word prompt you to confirm conversion when inserting files in formats other than the Word Document format.
Link Optional Variant True to insert the file by using an INCLUDETEXT field.
Attachment Optional Variant True to insert the file as an attachment to an e-mail message.

Example

This example uses an INCLUDETEXT field to insert the TEST.DOC file at the insertion point.

Visual Basic for Applications 
  Selection.Collapse Direction:=wdCollapseEnd
Selection.InsertFile FileName:="C:\TEST.DOC", Link:=True

This example creates a new document and then inserts the contents of each text file in the C:\TMP folder into the new document.

Visual Basic for Applications 
  Documents.Add
ChDir "C:\TMP"
myName = Dir("*.TXT")
While myName <> ""
    With Selection
        .InsertFile FileName:=myName, ConfirmConversions:=False
        .InsertParagraphAfter
        .InsertBreak Type:=wdSectionBreakNextPage
        .Collapse Direction:=wdCollapseEnd
    End With
    myName = Dir()
Wend

See Also