.. highlightlang:: us

.. _auto_setfilenamedialoginit:

auto_SetFileNameDialogInit
==========================

.. index:: auto_SetFileNameDialogInit

.. us.tag  auto_SetFileNameDialogInit ENGLISH

:ref:`auto_SetFileNameDialogInit` sets the search filter and search
path for the function :ref:`auto_GetFileNameDialog`.

.. function::  bool = auto_SetFileNameDialogInit(ssFilter)
    bool = auto_SetFileNameDialogInit(ssFilter, ssSearchPath)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1);
otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: ssFilter

   *ssFilter* is a string with the search filter.
   The filters are separated by one semicolon ``";"``.
   Example:
   ``"*.xls; *.nc; DE*.TXT; WOT_Test?.dat"``.

.. uparam:: ssSearchPath

   *ssSearchPath* is a string with the search
   path. The different path names are separated  by one semicolon ``";"``.
   Example:
   ``"c:/data/engine2; d:/data/engine1; d:/data/engine3"``.

.. us.example

**Example**

::

   auto_SetFileNameDialogInit("*.nc; *.dat; *.csv", "c:/mydata/test1/");
   auto_GetFileNameDialog(3);

.. seealso::
   :ref:`overview-automation`,
   :ref:`auto_GetFileNameDialog`

:sub:`id-1106971`