.. highlightlang:: us

.. _radiocontrol_group:

RadioControl_Group
==================

.. index:: RadioControl_Group

.. us.tag  RadioControl_Group ENGLISH New450 DialogBoxes

:ref:`RadioControl_Group` clears all radio buttons in the group each time the user 
selects a button.

.. function::  svInit = RadioControl_Group(svInit, iRadio, rvGroup)

.. us.return

**Return Value**

*svInit* is a string vector which contains the initializing string for
each dialog element. The initializing string for a radio button is either the string
``"1"`` or ``"0"``.

.. us.params

**Parameters**

.. uparam:: svInit

   *svInit* is a string vector which contains the initializing string for
   each dialog element. The initializing string for a radio button is either the string
   ``"1"`` or ``"0"``.

.. uparam:: iRadio

   *iRadio* is the index of the radio button and refers to the vector
   *svInit*.

.. uparam:: rvGroup

   *rvGroup* is an index vetor with the indices of all radio buttons of a group
   of radio button.

.. us.history

**History**

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

   * - Version
     - Description
   * - 4.5.0
     - New

.. us.example

**Example**

::

   def _Radio1(svInit, iRadio) 
   { 
       return RadioControl_Group(svInit, iRadio, [2, 3, 4]); 
   }
   def _Radio2(svInit, iRadio) 
   { 
       return RadioControl_Group(svInit, iRadio, [6, 7, 8, 9]); 
   }
   def RadioDialogBox()
   {
       svTemplate = ["|G4                                  |", ..
                     "|BR Radio 1    @_Radio1|", ..
                     "|BR Radio 2    @_Radio1|", ..
                     "|BR Radio 3    @_Radio1|", ..
                     "", ..
                     "|G5                                  |", ..
                     "|BR Radio 1    @_Radio2|", ..
                     "|BR Radio 2    @_Radio2|", ..
                     "|BR Radio 3    @_Radio2|", ..
                     "|BR Radio 4    @_Radio2|", ..
                     ""];
       svInit = ["Group 1", "1", "0", "0", "Group2", "1", "0", "0", "0"];
       DialogBox(svTemplate, svInit, "Example 18");
   }

.. seealso::
   :ref:`overview-dialogboxes`,
   :ref:`DialogBox`

:sub:`id-222569`