Saves the specified document with a new name or format. The arguments for this method correspond to the options in the Save As dialog box (File menu).

expression   Required. An expression that returns a Document object.

FileName   Optional Variant. The name for the document. The default is the current folder and file name. If the document has never been saved, the default name is used (for example, Doc1.doc). If a document with the specified file name already exists, the document is overwritten without the user being prompted first.

 WdSaveFormat

WdSaveFormat can be one of these WdSaveFormat constants.

wdFormatDocument  Saves as a Word document. Default.

wdFormatDOSText  Saves text without formatting. Converts all section breaks, page breaks, and new line characters to paragraph marks. Uses the ANSI character set. Use this format to share documents between Word and DOS-based programs.

wdFormatDOSTextLineBreaks  Saves text without formatting. Converts all line breaks, section breaks, and page breaks to paragraph marks. Use this format when you want to maintain line breaks, for example, when transferring documents to an electronic mail system.

wdFormatEncodedText Saves as an encoded text file. Use the Encoding argument to specify the code page to use.

wdFormatHTML  Saves all text and formatting with HTML tags so that the resulting document can be viewed in a Web browser.

wdFormatRTF  Saves all formatting. Converts formatting to instructions that other programs, including compatible Microsoft programs, can read and interpret.

wdFormatTemplate  Saves as a Word template.

wdFormatText  Saves text without formatting. Converts all section breaks, page breaks, and new line characters to paragraph marks. Uses the ANSI character set. Use this format if the destination program cannot read any of the other available file formats.

wdFormatTextLineBreaks  Saves text without formatting. Converts all line breaks, section breaks, and page breaks to paragraph marks. Use this format when you want to maintain line breaks, for example, when transferring documents to an electronic mail system.

wdFormatUnicodeText  Saves as a Unicode text file. Converts text between common character encoding standards, including Unicode 2.0, Mac OS, Windows, EUC and ISO-8859 series.

Other File Types  To save in a file type for which there isn't a constant, use the FileConverters object to obtain the SaveFormat property; then set the FileFormat argument to the value of the SaveFormat property.

LockComments   Optional Variant. True to lock the document for comments. The default is False.

Password   Optional Variant. A password string for opening the document.

AddToRecentFiles   Optional Variant. True to add the document to the list of recently used files on the File menu. The default is True.

WritePassword   Optional Variant. A password string for saving changes to the document.

ReadOnlyRecommended   Optional Variant. True to have Microsoft Word suggest read-only status whenever the document is opened. The default is False.

EmbedTrueTypeFonts   Optional Variant. True to save TrueType fonts with the document. If omitted, the EmbedTrueTypeFonts argument assumes the value of the EmbedTrueTypeFonts property.

SaveNativePictureFormat   Optional Variant. If graphics were imported from another platform (for example, Macintosh), True to save only the Windows version of the imported graphics.

SaveFormsData   Optional Variant. True to save the data entered by a user in a form as a data record.

SaveAsAOCELetter   Optional Variant. If the document has an attached mailer, True to save the document as an AOCE letter (the mailer is saved).

 MsoEncoding

MsoEncoding can be one of these MsoEncoding constants.

msoEncodingArabic

msoEncodingArabicASMO

msoEncodingArabicAutoDetect Not used with this method.

msoEncodingArabicTransparentASMO

msoEncodingAutoDetect Not used with this method.

msoEncodingBaltic

msoEncodingCentralEuropean

msoEncodingCyrillic

msoEncodingCyrillicAutoDetect Not used with this method.

msoEncodingEBCDICArabic

msoEncodingEBCDICDenmarkNorway

msoEncodingEBCDICFinlandSweden

msoEncodingEBCDICFrance

msoEncodingEBCDICGermany

msoEncodingEBCDICGreek

msoEncodingEBCDICGreekModern

msoEncodingEBCDICHebrew

msoEncodingEBCDICIcelandic

msoEncodingEBCDICInternational

msoEncodingEBCDICItaly

msoEncodingEBCDICJapaneseKatakanaExtended

msoEncodingEBCDICJapaneseKatakanaExtendedAndJapanese

msoEncodingEBCDICJapaneseLatinExtendedAndJapanese

msoEncodingEBCDICKoreanExtended

msoEncodingEBCDICKoreanExtendedAndKorean

msoEncodingEBCDICLatinAmericaSpain

msoEncodingEBCDICMultilingualROECELatin2

msoEncodingEBCDICRussian

msoEncodingEBCDICSerbianBulgarian

msoEncodingEBCDICSimplifiedChineseExtendedAndSimplifiedChinese

msoEncodingEBCDICThai

msoEncodingEBCDICTurkish

msoEncodingEBCDICTurkishLatin5

msoEncodingEBCDICUnitedKingdom

msoEncodingEBCDICUSCanada

msoEncodingEBCDICUSCanadaAndJapanese

msoEncodingEBCDICUSCanadaAndTraditionalChinese

msoEncodingEUCChineseSimplifiedChinese

msoEncodingEUCJapanese

msoEncodingEUCKorean

msoEncodingEUCTaiwaneseTraditionalChinese

msoEncodingEuropa3

msoEncodingExtAlphaLowercase

msoEncodingGreek

msoEncodingGreekAutoDetect Not used with this method.

msoEncodingHebrew

msoEncodingHZGBSimplifiedChinese

msoEncodingIA5German

msoEncodingIA5IRV

msoEncodingIA5Norwegian

msoEncodingIA5Swedish

msoEncodingISO2022CNSimplifiedChinese

msoEncodingISO2022CNTraditionalChinese

msoEncodingISO2022JPJISX02011989

msoEncodingISO2022JPJISX02021984

msoEncodingISO2022JPNoHalfwidthKatakana

msoEncodingISO2022KR

msoEncodingISO6937NonSpacingAccent

msoEncodingISO885915Latin9

msoEncodingISO88591Latin1

msoEncodingISO88592CentralEurope

msoEncodingISO88593Latin3

msoEncodingISO88594Baltic

msoEncodingISO88595Cyrillic

msoEncodingISO88596Arabic

msoEncodingISO88597Greek

msoEncodingISO88598Hebrew

msoEncodingISO88599Turkish

msoEncodingJapaneseAutoDetect Not used with this method.

msoEncodingJapaneseShiftJIS

msoEncodingKOI8R

msoEncodingKOI8U

msoEncodingKorean

msoEncodingKoreanAutoDetect Not used with this method.

msoEncodingKoreanJohab

msoEncodingMacArabic

msoEncodingMacCroatia

msoEncodingMacCyrillic

msoEncodingMacGreek1

msoEncodingMacHebrew

msoEncodingMacIcelandic

msoEncodingMacJapanese

msoEncodingMacKorean

msoEncodingMacLatin2

msoEncodingMacRoman

msoEncodingMacRomania

msoEncodingMacSimplifiedChineseGB2312

msoEncodingMacTraditionalChineseBig5

msoEncodingMacTurkish

msoEncodingMacUkraine

msoEncodingOEMArabic

msoEncodingOEMBaltic

msoEncodingOEMCanadianFrench

msoEncodingOEMCyrillic

msoEncodingOEMCyrillicII

msoEncodingOEMGreek437G

msoEncodingOEMHebrew

msoEncodingOEMIcelandic

msoEncodingOEMModernGreek

msoEncodingOEMMultilingualLatinI

msoEncodingOEMMultilingualLatinII

msoEncodingOEMNordic

msoEncodingOEMPortuguese

msoEncodingOEMTurkish

msoEncodingOEMUnitedStates

msoEncodingSimplifiedChineseAutoDetect Not used with this method.

msoEncodingSimplifiedChineseGBK

msoEncodingT61

msoEncodingTaiwanCNS

msoEncodingTaiwanEten

msoEncodingTaiwanIBM5550

msoEncodingTaiwanTCA

msoEncodingTaiwanTeleText

msoEncodingTaiwanWang

msoEncodingThai

msoEncodingTraditionalChineseAutoDetect Not used with this method.

msoEncodingTraditionalChineseBig5

msoEncodingTurkish

msoEncodingUnicodeBigEndian

msoEncodingUnicodeLittleEndian

msoEncodingUSASCII

msoEncodingUTF7

msoEncodingUTF8

msoEncodingVietnamese

msoEncodingWestern

InsertLineBreaks  Optional Variant. If the document is saved as a text file, True to insert line breaks at the end of each line of text.

AllowSubstitutions  Optional Variant. If the document is saved as a text file, True allows Word to replace some symbols with text that looks similar. For example, displaying the copyright symbol as (c). The default is False.

 WdLineEndingType

WdLineEndingType can be one of these WdLineEndingType constants.

wdCRLF Default.

wdCROnly

wdLFCR Not used with this method.

wdLFOnly Not used with this method.

wdLSPS Not used with this method.

AddBiDiMarks  Optional Variant. True adds control characters to the output file to preserve bi-directional layout of the text in the original document.

Example

This example saves the active document as Test.rtf in rich-text format (RTF).

Sub SaveAsRTF()
    ActiveDocument.SaveAs FileName:="Text.rtf", _
        FileFormat:=wdFormatRTF
End Sub

This example saves the active document in text-file format with the file extension ".txt".

Sub SaveAsTextFile()
    Dim strDocName As String
    Dim intPos As Integer

    'Find position of extension in filename
    strDocName = ActiveDocument.Name
    intPos = InStrRev(strDocName, ".")

    If intPos = 0 Then

        'If the document has not yet been saved
        'Ask the user to provide a filename
        strDocName = InputBox("Please enter the name " & _
            "of your document.")
    Else

        'Strip off extension and add ".txt" extension
        strDocName = Left(strDocName, intPos - 1)
        strDocName = strDocName & ".txt"
    End If

    'Save file with new extension
    ActiveDocument.SaveAs FileName:=strDocName, _
        FileFormat:=wdFormatText
End Sub

This example loops through all the installed converters, and if it finds the WordPerfect 6.0 converter, it saves the active document using the converter.

Sub SaveWithConverter()

    Dim cnvWrdPrf As FileConverter

    'Look for WordPerfect file converter
    'And save document using the converter
    'For the FileFormat converter value
    For Each cnvWrdPrf In Application.FileConverters
        If cnvWrdPrf.ClassName = "WrdPrfctWin" Then
            ActiveDocument.SaveAs FileName:="MyWP.doc", _
                FileFormat:=cnvWrdPrf.SaveFormat
        End If
    Next cnvWrdPrf

End Sub

This example saves NewFile.doc with a write password and then closes the document.  This example assumes that one of the open files is named "NewFile.doc."  If not, Word displays an error message.

Sub SaveWithPassword()
    With Documents("NewFile.doc")
        .SaveAs WritePassword:="pass"
        .Close
    End With
End Sub