.. highlightlang:: us

.. _reportcontrol_getinit:

ReportControl_GetInit
=====================

.. index:: ReportControl_GetInit

.. us.tag  ReportControl_GetInit GERMAN New422 DialogBoxes Changed530 Changed550

:ref:`ReportControl_GetInit` wandelt eine String-Matrix in einen
skalaren String um, mit dem das entsprechende ReportControl
der :ref:`DialogBox`-Funktion initialisiert werden kann.

.. function::  ssInit = ReportControl_GetInit(smMatrix)
    ssInit = ReportControl_GetInit(smMatrix, bUseSaveSep)
    ssInit = ReportControl_GetInit(smMatrix, bUseSaveSep, smSel)
    ssInit = ReportControl_GetInit(smMatrix, bUseSaveSep, rvSel)

.. us.return

**Returnwert**

*ssInit* ist ein skalarer String, mit dem das ReportControl der 
:ref:`DialogBox`-Funktion initialisiert werden kann.

.. us.params

**Parameter**

.. uparam:: smMatrix

   *smMatrix* ist eine String-Matrix, deren Anzahl Spalten mit der 
   Anzahl der Spalten des ReportControls übereinstimmen muss.

.. uparam:: bUseSaveSep

   *bUseSaveSep* legt die Trennzeichen für die Zellen fest. Wird der
   Parameter nicht angegeben, werden die Records durch ein Oder-Zeichen
   ``|`` getrennt und die Elemente eines Records durch ``\t``.
   Die selektieren Elemente werden durch ein ``@``-Zeichen getrennt.
   Falls der Parameter mit dem Wert TRUE (1) übergeben wird, wird anstatt 
   des Oder-Zeichens ``|`` das Zeichen ``\0x01`` verwendet.
   Elemente, die selektiert sein sollen, werden durch 
   das Zeichen ``\0x02`` anstatt des ``@``-Zeichen getrennt.
   In diesem Fall muss die Zeichenkette mit dem Wert ``\0x01`` beginnen. 
   Die Trennzeichen ``\0x01`` und ``\0x02`` müssen verwendet
   werden, falls das Control "Marker"-Comboboxen enthält. Bei Marker-Comboboxen
   hat das ``@``-Zeichen eine besondere Bedeutung und darf deshalb
   nicht im Init-String als Trennzeichen verwendet werden.
   Die Elemente einer Zeile werden durch ein Tabulator-Zeichen "``\t``" getrennt.

.. uparam:: smSel

   *smSel* ist eine String-Matrix mit den Zeilen, die selektiert angezeigt werden 
   sollen. Dia Anzahl der Spalten muss mit der Anzahl der Spalten des ReportControls 
   übereinstimmen.
   muss. 

.. uparam:: rvSel

   *rvSel* ist eine Vektor mit den Zeilenindizes der Matrix *smMatrix*, die 
   im Dialogfeld selektiert angezeigt werden sollen. Für den Wert 0 wird keine
   Zeile selektiert. 

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.5.0
     - *rvSel* = 0 ist gültig.
   * - 5.3.0
     - Erweitert um dritten Parameter
   * - 4.2.2
     - Neu

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

:sub:`id-963202`