.. highlightlang:: us

.. index:: QV_MainProg

.. _qv_mainprog:

QV_MainProg
===========

.. us.tag  QV_MainProg GERMAN

Mit :ref:`QV_MainProg` können Sie den Befehl :ref:`dateikanal-schnellansicht` von
UniScript aus ausführen.

.. function::  bool = QV_MainProg(ssTemplate, svFiles, ssXChannel, svChannels, svText, rvOptions)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und FALSE (0), wenn die
Funktion nicht erfolgreich war.

.. us.params

**Parameter**

.. uparam:: ssTemplate

   *ssTemplate* ist der Name der Vorlagendatei. Die Datei sollte sich im
   Verzeichnis :file:`Template\\qv` befinden. Die Vorlagendatei muss einen
   speziellen Aufbau haben (siehe :ref:`dateikanal-schnellansicht`).

.. uparam:: svFiles

   *svFiles* ist ein Stringvektor von Dateinamen, z. B.
   ``["c:/Data/file1.xls", "c:/Data/file2.xls"]``.

.. uparam:: ssXChannel

   *ssXChannel* ist der Name des X-Kanals. Falls kein X-Kanal vorhanden ist, kann
   ein leerer String (``ssXChannel = ""``) angegeben werden.

.. uparam:: svChannels

   *svChannels* ist ein String-Vektor mit Kanalnamen.

.. uparam:: svText

   *svText* ist ein Stringvektor mit Texten.

.. uparam:: rvOptions

   *rvOptions* ist ein Vektor mit drei Elementen:
   ``[bShowFileOpenDlg, bShowChannelSelectDlg, bShowTextInputDlg]``.

.. us.comment

**Kommentar**

Die Funktionen des Befehls :ref:`dateikanal-schnellansicht` bzw. die Funktion
:ref:`QV_MainProg` sind in UniScript programmiert. Siehe Dateien :file:`rs_qv.ic`,
:file:`rs_qv_dg.ic`, :file:`rs_qv_i.ic`, :file:`rs_qv_st.ic` im
:file:`UniPlot\\Script`-Verzeichnis.

.. us.example

**Beispiel**

Das folgende Programm importiert die beiden Datendateien
:file:`Samples\\Test1.xls` und :file:`Samples\\Test2.xls`. Anschließend werden
die Kanäle ``"SB"``, ``"SZ"``, ``"EngPwr"``, ``"SAEPwr"`` über ``"EngSpd"`` in
der Vorlage :file:`Template\\qv\\Default.ipw` dargestellt. Da *rvOptions* auf
``[0,0,0]`` gesetzt wurde, werden während der Ausführung von :ref:`QV_MainProg`
keine Dialog-Boxen angezeigt.

::

   def Sample_1()
   {
       ssTemplate = "Default";

       ssPath = GetRootDirectory() + "Samples/";
       svFiles = ssPath + ["Test1", "Test2"] + ".xls";

       ssXChannel = "EngSpd";
       svChannels = ["SB", "SZ", "EngPwr", "SAEPwr"];

       svText = ["Text1", "Text2"];

       bShowFileOpenDlg = 0;
       bShowChannelSelectDlg = 0;
       bShowTextInputDlg = 0;

       rvOptions = [bShowFileOpenDlg, bShowChannelSelectDlg, bShowTextInputDlg]
       QV_MainProg(ssTemplate, svFiles, ssXChannel, svChannels, svText, rvOptions);
   }
   Sample_1()

.. seealso::
   :ref:`dateikanal-schnellansicht`

:sub:`id-857604`