online feedbacks

Documentation

Callbacks in Skripte definieren

Callbacks in Skripte definieren


Konzept

Jede Benutzeraktion im Fragebogen kann vom Skripting abgefangen werden. Dazu werden sog. Callbacks verwendet.
Ein Callback kann ab der init() Phase im Fragebogen definiert werden.

Syntax

Um einen Callback zu definieren gibt es die pagecall Funktion des Fragebogen Objektes:
qst.pagecall([Seite], [Event], "[Funktionsname]()");


ParameterBeschreibung
Seite Seite für die der Callback gesetzt wird
Event Konstante des Events. Folgende Konstanten sind definiert: ON_ENTER, ON_EXIT, ON_FORWARD, ON_BACK
Funktionsname Name der Funktion welche aufgerufen wird


Beispiel 1: Callback für Verlassen von Seite 1

void init() {
    // Define a callback on exit of page 1
    qst.pagecall(1, ON_EXIT, "page1()");
}

void page1() {
    System.out.println("Exiting page 1");
}


Beispiel 2: Callback für mehrere Seiten

void init() {
    // Call the same check function
    qst.pagecall(1, ON_EXIT, "check(1)");
    qst.pagecall(2, ON_EXIT, "check(2)");
    qst.pagecall(3, ON_EXIT, "check(3)");
    qst.pagecall(10, ON_EXIT, "check(10)");
}

void check(p) {
    System.out.println("Exiting page "+p);
}