This script is called when the user clicks the Finish button in the Setup dialog if you've defined any custom setup settings in a Setup.Settings script. It gives you an opportunity to do something about the changes, such as storing a value in another location.

If your Options.Settings and Setup.Settings scripts are the same, you may wish to use the same code you have in Setup.Changed in an Options.Changed script. The best way to do that is to create a user-defined script with the necessary code and call that script from both Options.Changed and Setup.Changed.

Parameters
A reference to the Stonefield Query Application object and an XML string containing the key values, former values, and new values of all custom options. The format for the XML is as follows:

<settings>
      <setting>
        <key>Registry key</key>
        <old>Former value</old>
        <new>New value</new>
      </setting>
      <setting>
        <key>Registry key</key>
        <old>Former value</old>
        <new>New value</new>
      </setting>
      ...
</settings>

The following elements are available:

  • key: the Registry key under HKEY_CURRENT_USER\Software\CompanyName\ApplicationName\Options (where CompanyName and ApplicationName are the values of the Company Name and Application Name configuration settings) that holds the value for the setting. Alternatively, if you're storing values in Data.INI, this is the key value under the Options section.

  • old: the former value for this option.

  • new: the value entered by the user.

Return Value
Any value (Stonefield Query ignores the return value).

Example
See the examples in Options.Changed.

See also

Options.Changed | Scripts | Setup.Settings | Setup.Validate