dlgCheckBox

Funktion

Definiert eine Checkbox.

Syntax

dlgCheckBox(string Text, int &Checked) [ statement ]

Beschreibung

Das dlgCheckBox-Statement definiert eine Checkbox mit dem angegebenen Text.

Wenn Text ein '&' enthält, wird das folgende Zeichen als Hotkey markiert. Wenn der Benutzer Alt+hotkey drückt, wird die Checkbox selektiert/deselektiert. Um ein '&'-Zeichen im Text zu verwenden, muss er mit einem Escape-Zeichen markiert werden.

dlgCheckBox wird hauptsächlich in dlgGroup benutzt, kann aber auch anders verwendet werden.
Alle Check-Boxen einnerhalb eines gemeinsamen Dialogs müssen unterschiedliche Checked-Variablen haben!

Wenn ein Benutzer eine dlgCheckBoxwählt, wird die entsprechende Checked-Variable auf 1 gesetzt, andernfalls ist sie auf 0 gesetzt. Der ursprüngliche Wert von Checked definiert, ob eine Checkbox anfänglich selektiert ist oder nicht. Wenn Checked ungleich 0 ist, ist die Checkbox defaultmäßig selektiert.

Das optionale statement wird jedesmal ausgeführt, wenn Sie die dlgCheckBox selektieren/deselektieren.

Beispiel

int mirror = 0;
int rotate = 1;
int flip   = 0;
dlgGroup("Orientation") {
  dlgCheckBox("&Mirror", mirror);
  dlgCheckBox("&Rotate", rotate);
  dlgCheckBox("&Flip", flip);
  }