.. highlightlang:: us

.. index:: GetDirectoryDialog

.. _getdirectorydialog:

GetDirectoryDialog
==================

.. us.tag  GetDirectoryDialog ENGLISH FILE_MISC DialogBoxes

:ref:`GetDirectoryDialog` displays a directory selection dialog.

.. function::  ssDirectory = GetDirectoryDialog()
    ssDirectory = GetDirectoryDialog(ssStartDir)
    ssDirectory = GetDirectoryDialog(ssStartDir, ssTitle)
    ssDirectory = GetDirectoryDialog(ssStartDir, ssTitle, ssInfo)
    ssDirectory = GetDirectoryDialog(ssStartDir, ssTitle, ssInfo, bShowFiles)

.. us.return

**Return Value**

*ssDiretory* is the selected directory. The directory includes a drive name and a
path name. The path name ends with a trailing backslash ("\\"), e.g. 
:file:`c:\\Windows\\System\\`. If the user clicks the Cancel button,
``"DLG_CANCEL"`` is returned.

.. us.params

**Parameters**

.. uparam:: ssStartDir

   Specifies the start directory. If the parameter is not valid or not specified,
   the dialog box starts with the current directory.

.. uparam:: ssTitle

   Specifies a dialog title.

.. uparam:: ssInfo

   *ssInfo* is a text that can be displayed in the dialog box.

.. uparam:: bShowFiles

   If *bShowFiles* is TRUE (1), files will be displayed in the dialog.

.. us.example

**Example**

::

   * GetDirectoryDialog("c:\\")
   c:\UniPlot\Script\

.. seealso::
   :ref:`overview-dialogboxes`,
   :ref:`GetWindowsDirectory`,
   :ref:`GetRootDirectory`,
   :ref:`GetOpenFileName`,
   :ref:`GetDirectory`,
   :ref:`IsDirectory`,
   :ref:`DialogBox`,
   :ref:`FS_MakeDirectory`

:sub:`id-2107347`