3_JavaScript - get-/set-Befehle

[size=85](entnommen und angepasst aus: [url=https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API]https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API[/url])[/size][br][br][icon]/images/ggb/toolbar/mode_mincells.png[/icon] [b][u][size=150]"Get-Befehle" - Getting the state of objects:[/size][/u][/b][br]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.[br][br]Dies passierst über vordefinierte "[b][i][color=#ff0000]get-Befehle[/color][/i][/b]": [url=https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Getting_the_state_of_objects]https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Getting_the_state_of_objects[/url][br][br][b][u]Die typischsten Befehle sind:[/u][/b][br][list][*][b][i][color=#6557d2]getValue(" ...")[/color][/i][/b][br]z.B. var a = ggbApplet.getValue("a");[br]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. [br]Es empfiehlt sich in beiden Umgebungen dieselbe Benennung zu verwenden.[br][br][/*][*][color=#6557d2][i][b]getValueString("...")[/b][/i][/color][br]z.B. var text1 = ggbApplet.getValueString("text1");[br]Die Zeichenfolge von text1 in der GeoGebra-Umgebung wird als Variable text1 in die JavaScript-Umgebung übernommen.[br][br][/*][*][b][i][color=#6557d2]get...coord("...")[/color][/i][/b][br]z.B. var xa = ggbApplet.getXcoord("A"), ya = ggbApplet.getYcoord("A"), za = ggbApplet.getZcoord("A");[br]Die Koordinaten des Punktes A in der GeoGebra-Umgebung werden als Variablen xa, ya und za in die JavaScript-Umgebung übernommen.[br][/*][/list]
[br][br][br][icon]https://www.geogebra.org/images/ggb/toolbar/mode_mincells.png[/icon] [size=150][u][b]"Set-Befehle" - Setting the state of objects:[/b][br][/u][size=100]Will man nun von der JavaScript-Umgebung Informationen an die GeoGebra-Umgebung schicken, verwendet man vordefinierte "[i][b][color=#ff0000]set-Befehle[/color][/b][/i]":[br][url=https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Setting_the_state_of_objects]https://wiki.geogebra.org/en/Reference:GeoGebra_Apps_API#Setting_the_state_of_objects[/url][br][br][b][u]Die typischsten Befehle sind:[/u][/b][br][list][*][b][i][color=#6557d2]setValue(" ...", ... )[/color][/i][/b][br]z.B. ggbApplet.setValue("a",1);[br]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);).[br][br][/*][*][b][color=#6557d2]setTextValue(" ... ", ... )[/color][/b][br]z.B. ggbApplet.setTextValue("text1","Die Geraden sind parallel und verschieden.");[br]Das Textfeld [i]text1[/i] erhält den Inhalt |[i]Die Geraden sind parallel und verschieden.|[/i] .[br][br][/*][*][b][color=#6557d2]setCoords(" ... ", ... , ... , ... )[/color][/b][br]z.B. ggbApplet.setCoords("A",0,2,-1);[br]Im dreidimensionalen Koordinatensystem erhält der Punkt A in der GeoGebra-Umgebung so die Koordinaten ( 0 | 2 | -1 ).[br][br][/*][/list][u][i]Weitere nützliche "set-Befehle" sind:[/i][/u][br][list][*][b][color=#6557d2]setColor[/color][/b][/*][*][b][color=#6557d2]setVisible[/color][/b][/*][*][b][color=#6557d2]setFixed[/color][/b][/*][/list][/size][/size]Das folgende Applet demonstriert die Syntax und die Verwendung dieser Befehle:
[u][b]Anmerkungen:[/b][/u][br]Der Befehl [b][color=#6557d2]ggbApplet.setColor("Name_Objekt",[i]rot von 0-255[/i],[i]grün von 0-255,blau von 0-255[/i]);[/color][/b] erlaubt die Farbangabe über RGB. [br][br]Der Befehl [color=#6557d2][b]ggbApplet.setFixed("Name_Objekt",[i]true/false für gesperrt[/i],[i]true/false für Auswahl erlaubt[/i]);[/b][/color] sieht oben z.B. wie folgt aus:[br][b][color=#6557d2]ggbApplet.setFixed("BUTTON",true,false);[/color][/b][br]Das bedeutet: Die Schaltfläche mit dem Namen "BUTTON" ist in diesem Fall fixiert (true) und die Auswahl ist nicht erlaubt (false).[br][br]Will man auch den Hintergrund des Buttons (oder Textfeldes usw.) verändern, benutzt man den GeoGebra-Befehl [url=https://wiki.geogebra.org/en/SetBackgroundColor_Command]https://wiki.geogebra.org/en/SetBackgroundColor_Command[/url] und den JavaScript-Befehl [color=#6557d2][b]ggbApplet.evalCommand("...");[/b][/color][br]Nähere Informationen zu diesem Befehl folgen auf der nächsten Seite dieses Buches.

Information: 3_JavaScript - get-/set-Befehle