Skripting

Dieser Text ist noch nicht übersetzt. Sie können das englische Original en:Manual:Scripting lesen. Wenn sie Übersetzer-Rechte haben, können sie den Text ergänzen.

GeoGebra unterstützt zwei Skriptsprachen -- GGBScript und Javascript. Skripte sind eine Abfolge von Aktionen die ausgelöstw erden durch:

• Klicken oder Update eines bestimmten Objektes
• Laden der Datei (im Fall von JavaScript)
• Javascript listeners (siehe auch [JavaScript])

Sie können die Skript-Funktion mithilfe des Eigenschaften-Dialog erreichen. Gehen Sie dazu auf den Kartenreiter Erweitert und setzten Sie ein Häkchen bei Ermögliche Skripting.

GGBScript

Sie können Skripte erzeugen, die GeoGebra-Befehle enthalten.

Beispiel:

• a ist ein Schieberegler von 1 bis 3, der nur ganzzahlige Werte zulässt
• liste1 = {"rot", "grün", "blau"}
• in den Eigenschaften von a setzen Sie das Skript "Bei Update" auf SetzeFarbe[a, Element[liste1, a]]
• wenn Sie nun den Schieberegler bewegen ändert er seine Farbe

JavaScript

JavaScript ist eine Programmiersprache die in zahlreichen Internettechnologien eingesetzt wird. Im Gegensatz zu GeoGebra Script müssen die Befehle nicht als einfache Sequenzen ausgeführt werden, sondern es können auch Kontrollstrukturen wie (if, while, for) verwendet werden. Sie finden ein gute Anleitung zur Verwendung von JavaScript auf developer.mozilla.org. In GeoGebra können Sie aber spezielle JavaScriptmethoden benutzen, um die Konstruktion zu verändern. Diese Methoden gehören zu den ggbApplet Objekten, was bedeutet, dass Sie diese durch ggbApplet.method_name(parameter,..,parameter) aufrufen können. Die vollständige Liste dieser Methoden finden Sie unter [JavaScript].

Beispiel:

for(var i =0;i<10;i++) 
   ggbApplet.evalCommand("A_"+i+"=(random()*10,random()*10)");

Dieses Skript erzeugt 10 Punkte von A₀ bis A₉ mit zufälligen Koordinaten.

GeoGebra beinhaltet seine eigene JavaScript-Engine. Wenn Sie dynamische Arbeitsblätter exportieren, können Sie zwischen dieser Engine oder derjenigen, die im Browser verwendet wird, auswählen. Wenn Sie JavaScript auf einer HTML Seite bearbeiten, so wird die ggbApplet Variable nicht initialisiert. Sie müssen zuerst ggbApplet=document.applets[0]; verwenden, um das ggbApplet korrekt verwenden zu können.

Global JavaScript

Im Global JavaScript Teil des Skripting Kartenreiters im Eigenschaften-Dialog können auch Funktionen oder Anweisungen definiert werden, die vor dem Laden der Konstruktion ausgeführt werden. Sie können auch Funktionen wie ggbOnInit() eingeben, welche automatisch ausgerufen werden, sobald Ihre Konstruktion geladen wird. Die Funktion ggbOnInit() kann auch für Listeners benutzt werden, wie das folgende Beispiel zeigt:

Beispiel:

function onAdd(name){
    alert("Objekt "+name+" wurde hinzugefügt.");
}

function ggbOnInit(){
    ggbApplet.registerAddListener("onAdd");
}

Zuerst haben wir die Funktion onAdd definiert, die eine Nachricht zeigt, die von gegebenen String abhängt. Danach legen wir fest, dass GeoGebra die Funktion ggbOnInit aufruft, sobald ein neues Objekt hinzugefügt wird. Wird unsere Konstruktion neu geladen, so wird die Funktion ggbOnInit aufgerufen. Ab diesem Zeitpunkt wird, wenn der Benutzer einen Punkt A hinzufügt, die Nachricht "Objekt A wurde hinzugefügt" angezeigt.

Sie können Listeners aber auch benutzen um Obejekte umzubennen, zu löschen oder Konstruktionen zu löschen. Eine komplette Auflistung finden Sie unter [JavaScript].

Anmerkung: Wird eine ggbApplet-Methode in Global JavaScript außerhalb von ggbOnInit benutzt, so funktioniert diese Methode erst richtig, wenn sie aufgerufen wird, bevor die Konstruktion geladen wird.

USB Logging

Für Data-Logging von Vernier USB Data Loggers, z. B. Go!Motion und Go!Temp können Sie einen Logger-Listener definieren, indem Sie die Mehtode registerLoggerListener verwenden. So ein Listeenr kann folgendermaßen aussehen:

function logger(value) {
   var d = value * 1;
   ggbApplet.evalCommand("(CopyFreeObject[a],"+d+")");
   ggbApplet.evalCommand("SetValue[a,a+1]");
}

Dieses Skript nimmt an, dass es eine freie Zahl a in der Konstruktion gibt. Jedes mal, wenn d geloggt wird, wird der Punkt (a,d) konstruiert und a wird erhöht.