Determines whether a document has any unsaved changes. Read/write.
Version Information Version Added: Visio 2.0
Syntax
expression.Saved
expression A variable that represents a Document object.
Return Value
Boolean
Remarks
Use caution when setting the Saved property for a document to True. If you set the Saved property to True and a user, or another program, makes changes to the document before it is closed, those changes will be lost—Microsoft Office Visio does not provide a prompt to save the document.
A document that contains embedded or linked OLE objects may report itself as unsaved even if the document's Saved property is set to True.
Example
This Microsoft Visual Basic for Applications (VBA) macro shows how to use the Saved property to determine whether a document has any unsaved changes. It also shows how to set the Saved property. Before running this macro, change path to the location where you want to save the drawing, and change filename to the name you'd like to assign the file.
Visual Basic for Applications
Public Sub Saved_Example()
Dim vsoDocument1 As Visio.Document
Dim vsoDocument2 As Visio.Document
Dim vsoPage As Visio.Page
Dim vsoShape As Visio.Shape
Set vsoPage = ThisDocument.Pages(1)
Set vsoShape = vsoPage.DrawOval(2.5, 7, 3.5, 9)
'Use the SaveAs method to save the document for the first time.
ThisDocument.SaveAs "<em>path\filename</em>.vsd"
'Use the Saved property to verify that the document was saved.
'Saved returns True (-1).
Debug.Print ThisDocument.Saved
'Force a change to the document by adding a shape.
Set vsoShape = vsoPage.DrawOval(4, 7, 5, 9)
'Use the Saved property to verify that the document changed
'since the last time is was saved.
'Saved returns False (0)
Debug.Print ThisDocument.Saved
'Use the Save method to save any new changes.
ThisDocument.Save
'Use the Saved property again to verify that
'the document was saved. Saved returns True (-1).
Debug.Print ThisDocument.Saved
'The Saved property can also be set. For example, change
'the document again so that the Saved property becomes False.
Set vsoShape = vsoPage.DrawRectangle(1, 1, 7, 7)
'Set the Saved property to True.
'Setting the Saved property to True does not save the document.
ThisDocument.Saved = True
'Close the document and then reopen it. Note that
'the rectangle was not saved.
Set vsoDocument1 = ThisDocument
vsoDocument1.Close
Set vsoDocument1 = Documents.Open("<em>path\filename</em>.vsd")