.. highlightlang:: us

.. index:: registry_load

.. _registry_load:

registry_load
=============

.. us.tag  registry_load ENGLISH uniplot-registry New590

:ref:`registry_load` copies all UniPlot settings from the specified XML file to 
the Windows registry.

.. function::  bool = registry_load(ssFilename)

.. us.return

**Return Value**

*bool*.

.. us.params

**Parameters**

.. uparam:: ssFilename

   *ssFileName* is the complete name of a UniPlot settings file. The name 
   normally has the extension :file:`.xml`.

.. us.comment

**Comment**

The function can be used to move UniPlot settings to another computer
or for backup.

With ``registry_save("d:/my-uniplot-settings.xml")`` all seetings
are written to a file.
The file can be modified:
(``EdCreate("d:/my-uniplot-settings.xml")``). Remove all unwanted settings.
``registry_save("d:/my-uniplot-settings.xml")`` copies the settings into
the registry.

::

   <uniplot-settings version='5.0'>

     <section name='AddIn'>
       <item name='AddIn' type='int'>2</item>
       <item name='AddIn_1' type='string'>RS_FIT/RS_FIT.ICL</item>
       <item name='AddIn_2' type='string'>RS_VS100/RS_VS100.ICL</item>
     </section>

     <section name='Settings'>
       <item name='custcolor0' type='int'>15724527</item>
       <item name='custcolor1' type='int'>16761928</item>
       <item name='custcolor2' type='int'>16777215</item>
     </section>

   </uniplot-settings>

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.9
     - New

.. seealso::
   :ref:`overview-application-object`,
   :ref:`registry_save`,
   :ref:`AppLoadSettings`,
   :ref:`AppSaveSettings`

:sub:`id-288484`