.. highlightlang:: us

.. _option_dialog:

option_dialog
=============

.. index:: option_dialog

.. us.tag  option_dialog NOTREADYENGLISH gui New560

:ref:`option_dialog` opens the option dialog box :ref:`toolsmore-options`.

.. function::  bool = option_dialog()
    bool = option_dialog(ssCategory)

.. us.return

**Return Value**

*bool* is TRUE (1) if the dialog box was closed by selecting the OK button.
Otherwise the return value is FALSE (0).

.. us.params

**Parameters**

.. uparam:: ssCategory

   *ssCategory* is an optional string with the name of a category. If the category
   exists it will be selected. The categories are listed in the list box
   of the left side of the dialog box.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.6.0
     - New

.. seealso::
   :ref:`overview-application-object`,
   :ref:`option_add`,
   :ref:`GetProfileString`,
   :ref:`GetProfileInt`

:sub:`id-3733`