Document.SaveSettings method - Developer Area

API Documentation > CorelDRAW > X7.4 > Document > IVGDocument

Document.SaveSettings method

Saves document settings that can be recalled later, including Unit, Drawing Origin, curve Precision, Reference Point, PreserveSelection, ShapeEnumdirection, and Apply To Duplicate

Syntax:

Sub SaveSettings(Optional ByVal Tag As String)

Parameters:

Name	Type	Description
Tag	String	Specifies the control whose value you want to preserve. Users can change the tag description to suit their needs.

Remarks:

The SaveSettings method saves the properties to the internal stack. You can specify a tag for the saved values. The tag can be used to retrieve specific settings saved earlier.

You can use the SaveSettings method to preserve current document settings such as the values of the following document properties: CurvePrecision, DrawingOriginX, DrawingOriginY, ReferencePoint, Unit, PreserveSelection, ShapeEnumDirection, and ApplyToDuplicate.

Examples:

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

Version Information:

CorelDRAW:	X7.4, X7, X7.6, X8, 2017, 2018, 2019, 2019.2, 2020, 2021, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25
Corel DESIGNER:	X7, 2017.1, 20.1, 2019.2, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25