.. highlightlang:: us

.. index:: GetOpenFileName_Data

.. _getopenfilename_data:

GetOpenFileName_Data
====================

.. us.tag  GetOpenFileName_Data GERMAN FILE_MISC DialogBoxes New5305

:ref:`GetOpenFileName_Data` öffnet ein Dialogfeld aus dem der Benutzer einen 
oder mehrere Dateinamen auswählen kann. Das Dialogfeld zeigt alle verfügbaren
Datenimportfilter an.

.. function::  svFileName = GetOpenFileName_Data(ssDir, bMultiselect, bSortByDate, bConvertToNC)

.. us.return

**Returnwert**

Die Funktion gibt entweder einen Vektor mit gültigen Dateinamen zurück
(komplett mit Laufwerks- und Pfadangabe) oder einen leeren String, falls
der Benutzer die Schaltfläche **Abbrechen** gewählt hat.
Wenn der Parameter *bConvertToNC* mit dem Wert TRUE (1) übergeben wird,
werden die Namen der erzeugten NC-Dateien zurück gegeben. 

.. us.params

**Parameter**

.. uparam:: ssDir

   Mit dem Parameter *ssDir* kann ein Pfad vorgegeben werden. Beispiel:
   :file:`c:/Programme/UniPlot/Data`. Falls *ssDir* einen vollständigen
   Dateinamen enthält, wird der Name zur Initialisierung der Textfeldes
   Dateinamen verwendet, falls die Datei existiert. Wird ein leerer String ("")
   angegeben, wird das zuletzt verwendete Verzeichnis angezeigt.

.. uparam:: bMultiselect

   Wenn *bMultipleSelect* den Wert TRUE (1) hat, kann der Benutzer mehrere
   Dateinamen auswählen.

.. uparam:: bSortByDate

   Falls für den Parameter der Wert TRUE (1) angegeben wird, werden die
   ausgewählten Dateien nach dem Datum der letzten Änderung sortiert.

.. uparam:: bConvertToNC

   Falls für den Paramter der Wert TRUE (1) angegeben wird, werden die
   ausgewählten Dateien in das NC-Format konvertiert und die Namen der NC-Dateien
   zurück gegeben.

**Kommentar**

Falls eine Excel-Datei mit mehreren Tabellenseiten ausgewählt wird, zeigt UniPlot
einen Auswahldialog für die Tabellenauswahl an, falls der Parameter
*bConvertToNC* auf TRUE (1) gesetzt ist.

.. us.example

**Beispiel**

Mit :ref:`GetProfileString` und :ref:`WriteProfileString` das ausgewählte
Verzeichnis sichern.

::

   ssDir = GetProfileString("Settings", "MY_LastDataDir", "", "");
   svFileName = GetOpenFileName_Data(ssDir, TRUE, TRUE, FALSE);
   if (svFileName[1] == "") {
       return "";
   }
   svPath = SplitPath(svFileName[1]);
   WriteProfileString("Settings", "MY_LastDataDir", sum(svPath[1,2]));

   ssNCFile = auto_ImportData(svFileName[1]);

**History**

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

   * - Version
     - Beschreibung
   * - 5.30.5
     - Neu

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`uberblick-dialogboxen`,
   :ref:`GetSaveFileName`,
   :ref:`GetOpenFileName`,
   :ref:`DialogBox`,
   :ref:`MessageBox`

:sub:`id-1623903`