AddFromFile Method

Microsoft Word Visual Basic

Adds the specified subdocument to the master document at the start of the selection and returns a Subdocument object.

Note  If the active view isn't either outline view or master document view, an error occurs.

expression.AddFromFile(Name, ConfirmConversions, ReadOnly, PasswordDocument, PasswordTemplate, Revert, WritePasswordDocument, WritePasswordTemplate)

expression    Required. An expression that returns a Subdocuments object.

Name    Required String. The file name of the subdocument to be inserted into the master document.

ConfirmConversions    Optional Variant. True to confirm file conversion in the Convert File dialog box if the file isn't in Word format.

ReadOnly    Optional Variant. True to insert the subdocument as a read-only document.

PasswordDocument    Optional Variant. The password required to open the subdocument if it's password protected.

PasswordTemplate    Optional Variant. The password required to open the template attached to the subdocument if the template is password protected.

Revert    Optional Variant. Controls what happens if Name is the file name of an open document. True to insert the saved version of the subdocument. False to insert the open version of the subdocument, which may contain unsaved changes.

WritePasswordDocument    Optional Variant. The password required to save changes to the document file if it's write protected.

WritePasswordTemplate    Optional Variant. The password required to save changes to the template attached to the subdocument if the template is write protected.

Example

This example adds a subdocument named "Subdoc.doc" to the active document.

ActiveDocument.ActiveWindow.View.Type = wdMasterView
ActiveDocument.Subdocuments.AddFromFile _
    Name:="C:\Subdoc.doc"
		

This example adds a password-protected subdocument named "Subdoc.doc" to the active document on a read-only basis and sets the PasswordDocument parameter to a String variable.

Selection.Range.Subdocuments.AddFromFile Name:="C:\Subdoc.doc", _
    ReadOnly:=True, PasswordDocument:=strPassword