.. highlightlang:: us

.. index:: GetListBoxText

.. _getlistboxtext:

GetListBoxText
==============

.. us.tag  GetListBoxText GERMAN New422 DialogBoxes Changed530

:ref:`GetListBoxText` zerlegt den return-Wert eines ComboBox- oder
Listbox-Controls der :ref:`DialogBox`-Funktion in einen String-Vektor.

.. function::  svSel = GetListBoxText(ssText)
    <svList, svSel> = GetListBoxText(ssText)
    <svList, svSel, rvSelIndex> = GetListBoxText(ssText)
    svSel = GetListBoxText(ssText, bSplit)
    <svList, svSel> = GetListBoxText(ssText, bSplit)
    <svList, svSel, rvSelIndex> = GetListBoxText(ssText, bSplit)

.. us.return

**Returnwert**

*svSel* ist ein Vektor mit den selektierten Elementen. *svList* ist ein Vektor
mit den Elementen des Listenfeldes. *rvSelIndex* ist ein reeller Vektor mit den
Indizes der in *svList* selektierten Elementen.

.. us.params

**Parameter**

.. uparam:: ssText

   *ssText* ist ein skalarer String, der von der DialogBox-Funktion oder einer
   Callback-Funktion geliefert wird. 

.. uparam:: bSplit

   *bSplit* legt fest, ob die Elemente in einen Vektor zerlegt werden sollen.
   Defaultwert ist TRUE (1).

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.2
     - Neu
   * - 4.2.4
     - Funktion kann nun die Separatoren ``|`` und ``@`` oder ``\0x01``  und ``\0x01`` verarbeiten.
   * - 5.3.0
     - Neuer return parameter *rvSelIndex*.

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

:sub:`id-1384116`