.. highlightlang:: us

.. index:: Kommandozeilenparameter
.. index:: Kommandozeile
.. index:: Befehlszeile
.. index:: command line
.. index:: AppGetCommandLine

.. _appgetcommandline:

AppGetCommandLine
=================

.. us.tag  AppGetCommandLine GERMAN App New300 Changed5502

:ref:`AppGetCommandLine` liefert die Kommandozeile.

.. function::  ssCommandLine = AppGetCommandLine()

.. us.return

**Returnwert**

*ssCommandLine* ist ein skalarer String ohne den Programmnamen. Für die
Kommandozeile
``c:\programme\uniplot\program\uniplot.exe /StartupFileName test.ic Para1 Para2``
liefert die Funktion den String ``/StartupFileName test.ic Para1 Para2``.

.. us.example

**Beispiel**

.. code-block:: us
   :linenos:
   :emphasize-lines: 10

   /*
      Datei my_startjob.ic

      Beispielaufruf:

      c:\uniplot\program\uniplot.exe /StartupFileName my_startjob.ic job.xml

      Erstmal die normale Startup-Datei laden:
   */
   load(GetRootDirectory() + "startup\\startup.ic");
   ssDir = GetRootDirectory() + "myscript\\";
   load(ssDir + "myscript.ic");
   ssCommands = AppGetCommandLine();
   if (ssCommands != "") { 
       <svCommands, svType> = StringToField(ssCommands);
       if (len(svCommands) == 3) {
           ssJobFile = svCommands[3];
           _my_job_execute(ssJobFile);
       }
   }

.. us.comment

**Kommentar**

Folgende Standard-Parameter werden zur Zeit verwendet:

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

   * - Name
     - Description
   * - ``/StartupFileName <file>``
     - Es wird nicht die Startupdatei :file:`startup\\startup.ic` geladen,
       sondern die angegebene Datei, siehe Beispiel. Für ``<file>`` muss ein 
       vollständiger IC-Dateiname angegeben werden.
   * - ``/Ini``
     - Entspricht ``/StartupFileName``.
   * - ``/NoAutoLoad``
     - Die Dateien in den AutoLoad-Verzeichnissen werden nicht geladen.
   * - ``/IniFileName <file>``
     - Zum Speichern von Programmeinstellungen, wie Anordnung der Toolbars, 
       Default-Verzeichnissen usw. wird nicht die Windows-Registry verwendet
       ``HKEY_CURRENT_USER\Software\RSB\UniPlot5`` sondern eine INI-Datei
       (Textdatei).
   * - ``/User <user>``
     - Einstellungen werden nicht in der Registry unter dem normalen Schlüssel
       ``HKEY_CURRENT_USER\Software\RSB\UniPlot5`` gespeichert , sondern unter 
       ``HKEY_CURRENT_USER\Software\RSB\UniPlot5\<user>``.
   * - ``/automation``
     - Uniplot wird gestartet, ohne das sein Fenster angezeigt wird (versteckt)
       Siehe auch :ref:`AppSetBatchMode`. 
   * - ``/RegServer``
     - Veraltet, wird bei jedem Start automatisch ausgeführt.
   * - ``/UnRegserver``
     - Veraltet, wird bei der Deinstallation automatisch ausgeführt.
   * - ``/BatchMode``
     - Startet UniPlot im Batch-Mode, siehe :ref:`AppSetBatchMode`.

Groß-/Kleinbuchstaben werden bei den Parametern nicht unterschieden.

Die Funktion :ref:`GetCommandLine` ist die entsprechende Funktion für den
UniScript-Interpreter (``us.exe``), siehe
:ref:`uniscript-as-a-stand-alone-program`.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.2
     - Beschreibung der Standard-Parameter
   * - 3.0
     - Neu.

.. seealso::
   :ref:`uberblick-application-objekt`,
   :ref:`AppQuit`,
   :ref:`strtok`,
   :ref:`GetCommandLine`,
   :ref:`AppSetBatchMode`

:sub:`id-1720758`