.. highlightlang:: us

.. index:: GetDirectoryDialog

.. _getdirectorydialog:

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

.. us.tag  GetDirectoryDialog GERMAN FILE_MISC DialogBoxes

:ref:`GetDirectoryDialog` zeigt ein Dialogfeld an, um ein Verzeichnis auswählen.

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

.. us.return

**Returnwert**

*ssDirectory* ist ein String mit dem ausgewählen Verzeichnisnamen. Der
Verzeichnisname besteht aus dem Laufwerksnamen und dem Verzeichnisnamen. Die
Funktion verwendet als Trennzeichen der einzelnen Verzeichnisebenen einen
Backslash (``"\\"``). 

Das Verzeichnis endet mit einem abschließenden Backslash (``"\\"``). Ein 
gültiger Verzeichnisname könnte z. B. so aussehen: :file:`c:\\Windows\\System\\`.
Falls der Benutzer die Schaltfläche **Abbrechen** wählt, enthält *ssDirectory*
den Wert ``"DLG_CANCEL"``.

.. us.params

**Parameter**

.. uparam:: ssStartDir

   Mit *ssStartDir* kann ein Start-Verzeichnis angegeben werden. Falls das
   Start-Verzeichnis ungültig ist oder die Funktion ohne Parameter aufgerufen
   wird, wird das Dialogfeld mit dem aktiven Verzeichnis initialisiert.

.. uparam:: ssTitle

   Mit *ssTitle* kann der Dialogtitel geändert werden.

.. uparam:: ssInfo

   *ssInfo* kann als zusätzlicher Text angezeigt werden.

.. uparam:: bShowFiles

   Falls *bShowFiles* TRUE (1) ist, werden auch die Dateien angezeigt.

.. us.example

**Beispiel**

::

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

.. seealso::
   :ref:`uberblick-dialogboxen`,
   :ref:`GetWindowsDirectory`,
   :ref:`GetRootDirectory`,
   :ref:`GetOpenFileName`,
   :ref:`GetDirectory`,
   :ref:`DialogBox`,
   :ref:`FS_MakeDirectory`

:sub:`id-2107347`