3_JavaScript - get-/set-Befehle
(entnommen und angepasst aus: https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API)
"Get-Befehle" - Getting the state of objects:
Mit GeoGebra Skript greift man direkt auf alle Inhalte der Algebra-Umgebung zu. Im Gegensatz dazu muss man in der JavaScript-Umgebung erst die Inhalte der Algebra-Umgebung abrufen.
Dies passierst über vordefinierte "get-Befehle": https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Getting_the_state_of_objects
Die typischsten Befehle sind:
"Get-Befehle" - Getting the state of objects:
Mit GeoGebra Skript greift man direkt auf alle Inhalte der Algebra-Umgebung zu. Im Gegensatz dazu muss man in der JavaScript-Umgebung erst die Inhalte der Algebra-Umgebung abrufen.
Dies passierst über vordefinierte "get-Befehle": https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Getting_the_state_of_objects
Die typischsten Befehle sind:
- getValue(" ...") z.B. var a = ggbApplet.getValue("a"); Der Wert von a in der GeoGebra-Umgebung wird als Variable a in die JavaScript-Umgebung übernommen. Dabei kann a eine Zahl oder auch ein boolescher Wert sein. Es empfiehlt sich in beiden Umgebungen dieselbe Benennung zu verwenden.
- getValueString("...") z.B. var text1 = ggbApplet.getValueString("text1"); Die Zeichenfolge von text1 in der GeoGebra-Umgebung wird als Variable text1 in die JavaScript-Umgebung übernommen.
- get...coord("...") z.B. var xa = ggbApplet.getXcoord("A"), ya = ggbApplet.getYcoord("A"), za = ggbApplet.getZcoord("A"); Die Koordinaten des Punktes A in der GeoGebra-Umgebung werden als Variablen xa, ya und za in die JavaScript-Umgebung übernommen.
"Set-Befehle" - Setting the state of objects:
Will man nun von der JavaScript-Umgebung Informationen an die GeoGebra-Umgebung schicken, verwendet man vordefinierte "set-Befehle":
https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Setting_the_state_of_objects
Die typischsten Befehle sind:
- setValue(" ...", ... ) z.B. ggbApplet.setValue("a",1); Der Wert von a in der GeoGebra-Umgebung wird auf 1 gesetzt. Ist a ein boolescher Ausdruck, so wird er auf wahr gesetzt (gleichbedeutender Befehl: ggbApplet.setValue("a",true);).
- setTextValue(" ... ", ... ) z.B. ggbApplet.setTextValue("text1","Die Geraden sind parallel und verschieden."); Das Textfeld text1 erhält den Inhalt |Die Geraden sind parallel und verschieden.| .
- setCoords(" ... ", ... , ... , ... ) z.B. ggbApplet.setCoords("A",0,2,-1); Im dreidimensionalen Koordinatensystem erhält der Punkt A in der GeoGebra-Umgebung so die Koordinaten ( 0 | 2 | -1 ).
- setColor
- setVisible
- setFixed
Anmerkungen:
Der Befehl ggbApplet.setColor("Name_Objekt",rot von 0-255,grün von 0-255,blau von 0-255); erlaubt die Farbangabe über RGB.
Der Befehl ggbApplet.setFixed("Name_Objekt",true/false für gesperrt,true/false für Auswahl erlaubt); sieht oben z.B. wie folgt aus:
ggbApplet.setFixed("BUTTON",true,false);
Das bedeutet: Die Schaltfläche mit dem Namen "BUTTON" ist in diesem Fall fixiert (true) und die Auswahl ist nicht erlaubt (false).
Will man auch den Hintergrund des Buttons (oder Textfeldes usw.) verändern, benutzt man den GeoGebra-Befehl https://wiki.geogebra.org/en/SetBackgroundColor_Command und den JavaScript-Befehl ggbApplet.evalCommand("...");
Nähere Informationen zu diesem Befehl folgen auf der nächsten Seite dieses Buches.