Document.RestoreSettings

Object Model Reference : Classes : D : Document : Methods : Document.RestoreSettings

Document.RestoreSettings

Sub RestoreSettings([Tag As String])

Description

The RestoreSettings method retrieves the properties saved in the internal stack using the SaveSettings method. If the Tag parameter is not specified, the last saved values are retrieved. If the tag is specified, all properties are removed from the stack until the properties with the tag is located. If a stack underflow occurs, the properties are reset to the default values in the following table.


Parameter	Description
Tag	Specifies the control whose value you want to preserve. Users can change the tag description to suit their needs. This parameter is optional.

VBA example

The following VBA example restores the document units to feet. The settings saved by the second SaveSettings method are discarded.

Sub Test()

With ActiveDocument

.Unit = cdrFoot

.SaveSettings "Settings1"

.Unit = cdrMillimeter

.SaveSettings "Settings2"

.Unit = cdrAgate

.RestoreSettings "Settings1"

End With

End Sub