.. highlightlang:: us

.. index:: CreateListBoxText

.. _createlistboxtext:

CreateListBoxText
=================

.. us.tag  CreateListBoxText GERMAN New422 DialogBoxes Chanded530

:ref:`CreateListBoxText` erzeugt für Listboxen und Comboboxen eines 
Dialogfelds den Initialisierungs-String.

.. function::  ssComboInit = CreateListBoxText(svList)
    ssComboInit = CreateListBoxText(svList, svSel)
    ssComboInit = CreateListBoxText(svList, rvSelIndex)

.. us.return

**Returnwert**

*ssComboInit* ist ein skalarer String für die Initialisierung von Listboxen und
ComboBoxen. Als Trennzeichen der Elemente wird die Werte ``\0x01`` verwendet. Die
Elemente, die selektiert angezeigt werden sollen, werden durch das Zeichen
``\0x02`` getrennt.

.. us.params

**Parameter**

.. uparam:: svList

   *svList* ist ein String-Vektor mit den anzuzeigenden Listenelementen.

.. uparam:: svSel

   *svSel* ist ein String-Vektor mit den zu selektierenden Elementen.
   Die Elemente werden nur selektiert, falls Sie im Vektor *svList*
   enthalten sind.

.. uparam:: rvSelIndex

   *rvSelIndex* ist ein Vektor mit den Indizes der zu selektierenden Elemente.
   Die Elemente werden nur selektiert, falls Sie im Vektor *svList*
   enthalten sind.

.. us.example

**Beispiel**

Die Trennzeichen werden im Kommandofenster nicht angezeigt. Beim Debuggen
kann man die Trennzeichen im Tooltip sehen.

::

   * svInit = ["Adam", "John", "Mary", "Jimmy"];
   * ssInit = CreateListBoxText(svInit, svInit[2,4]);
   * ssInit
   \x01Adam\x01John\x01John\x01Mary\x01Jimmy\x02John\x01Jimmy
   * svSel = GetListBoxText(ssInit);
   * svSel'
    John
    Jimmy
   * <svList, svSel> = GetListBoxText(ssInit);
   * svList'
    Adam
    John
    Mary
    Jimmy

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.2
     - Neu
   * - 5.3.0
     - Neuer Parameter *rvSelIndex*.

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

:sub:`id-1694839`