PPT97: How To Use the SaveAs Method

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements.

SaveAs Parameters

The SaveAs method has three parameters:

   Name           Data Type    Required
   ----           ---------    --------
   Filename       String       Yes
   FileFormat     Long         Optional
   EmbedFonts     Long         Optional
				

The Filename parameter specifies the name you want to assign to the file. If you do not specify the path, PowerPoint saves the file in the current folder.

The following example saves a PowerPoint presentation, called test.ppt to the root of the C:\ drive.

   Sub SaveAsNormal()
      ActivePresentation.SaveAs "c:\test.ppt"
   End Sub
				

NOTE: If a file named test.ppt already exists in the specified location, PowerPoint overwrites the file.

The FileFormat parameter specifies the file format and uses one of the following PpSaveAsFileType constants:

   Constant               Description
   --------               -----------
   ppSaveAsAddIn          Saves as a PowerPoint add-in (.ppa)
   ppSaveAsPowerPoint3    Saves as PowerPoint 3
   ppSaveAsPowerPoint4    Saves as PowerPoint 4
   ppSaveAsPowerPoint7    Saves as PowerPoint 95
   ppSaveAsPresentation   Saves as PowerPoint 97
   ppSaveAsRTF            Saves as Rich Text Format (.rtf)
   ppSaveAsTemplate       Saves as PowerPoint template (.pot)
				

The following macro example saves a presentation called "PowerPoint 95 presentation" in the root directory, in PowerPoint 95 format.

   SSub SaveAs95()
      Const ThePath As String = "c:\"
      Const FileName As String = "PowerPoint 95 presentation"

      With ActivePresentation
         .SaveAs ThePath & FileName, ppSaveAsPowerPoint7
      End With
   End Sub
				

The EmbedFonts parameter specifies whether or not TrueType fonts are embedded in the presentation when you save it. To embed the TrueType fonts, use the msoTrue value. The default value is msoFalse.

   Sub EmbedTheFonts()
      With ActivePresentation
         .SaveAs "c:\test", ppSaveAsPresentation, msoTrue
      End With
   End Sub
				

Using Error Trapping with the SaveAs Method

The following sample macro demonstrates how to trap errors that may occur when you use the SaveAs Method.

   Sub ErrorTrapSaveAs()
      On Error Resume Next
      Err.Clear
      With ActivePresentation
         ActivePresentation.SaveAs "c:\bad file"
         ' Check if error occurred when saving the presentation.
         If Err.Number <> 0 Then
            ' Display a message box with the error description and number.
            MsgBox Err.Description, vbInformation, Err.Number
         End If
      End With
   End Sub