dlgRadioButton

Funktion

Definiert einen Radio-Button.

Syntax

dlgRadioButton(string Text, int &Selected) [ statement ]

Beschreibung

Das dlgRadioButton-Statement definiert einen Radio-Button mit dem angegebenen Text.

Enthält Text ein '&'-Zeichen, wird das folgende Zeichen zum Hot-Key. Wenn der Benutzer dann Alt+hotkey drückt, wird dieser Button selektiert. Soll ein '&'-Zeichen im Text verwendet werden, muss es mit einem Escape-Zeichen markiert werden.

dlgRadioButton kann nur innerhalb einer dlgGroup verwendet werden.
Alle Radio-Buttons innerhalb derselben Group müssen dieselbe Selected-Variable haben!

Wenn der Benutzer einen dlgRadioButton selektiert, wird der Index dieses Buttons innerhalb der dlgGroup in der Selected-Variablen gespeichert.
Der Ausgangswert von Selected definiert, welcher Radio-button per default selektiert ist. Liegt Selected ausserhalb des gültigen Bereichs dieser Group, ist kein Radio-Button selektiert. Um die richtige Radio-Button-Selektion zu erhalten, muss Selected schon vor der Definition des ersten dlgRadioButton festgelegt werden, und darf nicht verändert werden, während man weitere Radio-Buttons hinzufügt. Ansonsten ist es ungewiss welcher Radio-Button (wenn überhaupt einer) selektiert wird.

Das optionale statement wird ausgeführt, wenn ein dlgRadioButton selektiet wird.

Beispiel

int align = 1;
dlgGroup("Alignment") {
  dlgRadioButton("&Top", align);
  dlgRadioButton("&Center", align);
  dlgRadioButton("&Bottom", align);
  }