Subdocuments.AddFromFile Method (Word)
Adds the specified subdocument to the master document at the start of the selection and returns a Subdocument object.
Syntax
expression .AddFromFile(Name, ConfirmConversions, ReadOnly, PasswordDocument, PasswordTemplate, Revert, WritePasswordDocument, WritePasswordTemplate)
expression Required. A variable that represents a Subdocuments collection.
Parameters
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
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 is 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 is write-protected. |
WritePasswordTemplate |
Optional |
Variant |
The password required to save changes to the template attached to the subdocument if the template is write-protected. |
Return Value
Subdocument
Remarks
If the active view isn't either outline view or master document view, an error occurs.
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