.. highlightlang:: us

.. _reportcontrol_getmatrix:

ReportControl_GetMatrix
=======================

.. index:: ReportControl_GetMatrix

.. us.tag  ReportControl_GetMatrix GERMAN New422 DialogBoxes Changed530

:ref:`ReportControl_GetMatrix` wandelt den Returnwert der :ref:`DialogBox`-Funktion
in eine String-Matrix um.

.. function::  smMatrix = ReportControl_GetMatrix(ssRet)
    <smMatrix, smSel> = ReportControl_GetMatrix(ssRet)
    <smMatrix, smSel, rvSelRow> = ReportControl_GetMatrix(ssRet)

.. us.return

**Returnwert**

*smMatrix* ist eine String-Matrix. 
*smSel* ist eine String-Matrix mit der Selection. 
*rvSelRow* ist ein Vektor mit den Indizes der selektierten Zeilen von *smMatrix*.
Falls keine Zeilen im Dialogfeld selektiert sind enthält die Variable den Wert 0. 

.. us.params

**Parameter**

.. uparam:: ssRet

   *ssRet* ist ein Element des Returnwerts der Funktion :ref:`DialogBox`. 

.. us.example

**Beispiel**

Beispiel für eine Dialog-Callback-Funktion, die über einen Schalter
im Dialogfeld aufgerufen werden könnte:

::

   def __DataFileList_EditNC(svInit)
   {
       <smList, svSel, rsSelRow> = ReportControl_GetMatrix(svInit[1]);

       if (rsSelRow == 0) {
           MessageBoxInfo("Select an element");
           return FALSE;
       }

       ssDir = _MakePathComplete(svSel[2]);
       ssFile = svSel[3];
       ssNCFile = ssDir + ssFile;
       ssNCFile = auto_ImportData(ssNCFile);
       ssNewName = NC_Edit(ssNCFile, 1);
       if (ssNewName != "") {
           svPath = SplitPath(ssNewName);
           smList[rsSelRow; 2] = sum(svPath[1,2]);
           smList[rsSelRow; 3] = sum(svPath[3,4]);
           svInit[1] = ReportControl_GetInit(smList, TRUE, rsSelRow);
       }
       return svInit;
   }

   

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.2
     - Neu
   * - 5.3.0
     - Neue return-Werte zugefügt

.. seealso::
   :ref:`uberblick-dialogboxen`,
   :ref:`DialogBox`,
   :ref:`ReportControl_GetInit`,
   :ref:`GetListBoxText`,
   :ref:`CreateListBoxText`

:sub:`id-204865`