查看“Comments:參考:JavaScript”的源代码

= GGB 檔中使用 JavaScript =
[[File:OnClick.png|frame|物件的 OnClick 事件]]
如果在物件的「程式」頁面中要使用 JavaScript 來控制 GGB 的話，可以使用 {{Key|ggbApplet|blue}} 這個關鍵字，然後用下面介紹的各種 JavaScript 指令。

{{Example|1=如果我們在一個物件的 OnClick 事件中輸入以下的程式碼，則當此物件被滑鼠按到時，會自動產生一個數列。}}

 var a = ggbApplet;
 a.evalCommand('n = 3');
 a.evalCommand('s = Sequence[k^2, k, 1, n]');

= 網頁中使用 JavaScript =
{{Example|1=下面的 HTML 網頁碼會在網頁中產生一個「按鈕」，按下此鈕時，繪圖區會回到初始狀態。}}
    <input type="button" value="重設" onclick="{{Key|document.applets[0].reset();|blue}}">

{{Example|1=下面的 HTML 網頁碼會產生兩個「按鈕」，第一個可以隱藏 A 點，第二個可以顯示 A 點。}}
    <input type="button" value="隱藏 A 點" onclick="document.applets[0].{{Key|setVisible('A', false)|blue}};">
    <input type="button" value="顯示 A 點" onclick="document.applets[0].{{Key|setVisible('A', true)|blue}};">

{{Example|1=下面的 HTML 網頁碼會產生一個「按鈕」，按下此鈕時，會畫出 AB 兩點，與通過此兩點的直線。}}
  <applet name="ggbApplet" ... > </applet>
  ......
  <script type="text/javascript">
    {{Key|1=function drawLineAB() {
      var applet = document.ggbApplet;
      applet.evalCommand("A = (1,1)"); 
      applet.evalCommand("B = (3,2)"); 
      applet.evalCommand("s = Line[A, B]"); 
    } |2=blue}}
  </script>
  ......
  <input type="button" value="Do construction" onclick="{{Key|drawLineAB()|blue}};">

{{Hint|請打開下面網頁的原始碼，你就可以看到如過透過 JavaScript 來控制 GGB 的實際例子。}}
* http://www.geogebra.org/source/program/applet/geogebra_applet_javascript_test.htm

{{Hint|下面的網頁用來示範「事件處理」的概念。當我們利用作圖工具產生新物件時，網頁中所設定的「新增物件處理器」會檢查你的作圖是否已經完成，然後給你適當的回應。}}
* http://www.geogebra.org/en/examples/javascriptAutomaticCheckingExercise.html

{{Hint|下面是一個利用 JavaScript 產生互動效果的例子。網頁開啟後，會隨機畫一條直線，你必須填入正確的「斜率」，如果回答正確，它會再隨機畫另一條直線讓你回答它的斜率。}}
* http://www.geogebra.org/web/milestones/SlopeTestWeb.html

= 通用指令 =
<table style="width: 100%;" class="pretty">
    <tr>
      <th>指令</th>
      <th style="text-align: center;">版本</th>
      <th>說明</th>
    </tr>
    <tr>
      <td>{{Key|evalCommand|blue}}(命令字串)</td>
      <td style="text-align: center;">3.0</td>
      <td> 執行「命令字串」中所指定的 GGB 指令，此與直接在「命令列」中下該指令有相同的效果。從 3.2 版起，我們可以在「命令字串」中加入特殊的「換行」字串「{{Key|\n|blue}}」，這樣一來，我們就可以同時下許多個指令。 <br><br> 回傳值：若執行成功則傳回 {{Key|true}}，若失敗則傳回 {{Key|false}}。<br>{{Example|1=<code>appApplet.{{Key|evalCommand}}('SetValue[n, 3]');</code>}}
      </td>
    </tr>
    <tr>
      <td>void setUndoPoint()</td>
      <td style="text-align: center;">3.2</td>
      <td> Sets an undo point. Useful if you want the user to be able to undo that action of evalCommand eg if you have made an HTML button to act as a custom tool<br>
      </td>    
      </tr>
</table>

=設定物件屬性=
<table style="width: 100%;" class="pretty">
    <tr>
      <th>函數</th>
      <th style="text-align: center;">版本</th>
      <th>說明</th>
    </tr>
    <tr>
      <td> void deleteObject(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Deletes the object with the given name.</td>
    </tr>
    <tr>
      <td>void setValue(String objName, double value)</td>
      <td style="text-align: center;">3.2</td>
      <td>Sets the double value of the object with the given name. Note: if the specified object is boolean, use a value of 1 to set it to true and any other value to set it to false. For any other object type, nothing is done.</td>
    </tr>
    <tr>
      <td>void setCoords(String objName, double x, double y)</td>
      <td style="text-align: center;">3.0</td>
      <td>Sets the coordinates of the object with the given name.
Note: if the specified object is not a point or a vector, nothing is done.</td>
    </tr>
    <tr>
      <td>void {{Key|setColor|blue}}(物件名, 紅, 綠, 藍)</td>
      <td style="text-align: center;">2.7</td>
      <td>設定物件的顏色，紅綠藍 (RGB) 的顏色值為 {{Key|0 ~ 255}}。<br />例如：<code>document.ggbApplet.{{Key|setColor|blue}}("lineAB", 255, 0, 0)</code></td>
    </tr>
    <tr>
      <td>void setVisible(String objName, boolean visible) </td>
      <td style="text-align: center;">2.7</td>
      <td>Shows or hides the object with the given name in the graphics window.</td>
    </tr>
    <tr>
      <td>void setLabelVisible(String objName, boolean visible) </td>
      <td style="text-align: center;">3.0</td>
      <td>Shows or hides the label of the object with the given name in the graphics window.</td>
    </tr>
    <tr>
      <td>void setLabelStyle(String objName, int style)</td>
      <td style="text-align: center;">3.0</td>
      <td>Sets the label style of the object with the given name in the graphics window. Possible label styles are NAME = 0, NAME_VALUE = 1, VALUE = 2 and (from GeoGebra 3.2) CAPTION = 3</td>
    </tr>
    <tr>
      <td>void setFixed(String objName, boolean flag)</td>
      <td style="text-align: center;">3.0</td>
      <td>Sets the fixed state of the object with the given name. Note: fixed objects cannot be changed.</td>
    </tr>
    <tr>
      <td>void setTrace(String objName, boolean flag)</td>
      <td style="text-align: center;">3.0</td>
      <td>Turns the trace of the object with the given name on or off.</td>
    </tr>
    <tr>
      <td>boolean renameObject(String oldObjName, String newObjName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Renames oldObjName to newObjName. Returns whether the rename was successful</td>
    </tr>
    <tr>
      <td>void setLayer(String objName, int layer)</td>
      <td style="text-align: center;">3.2</td>
      <td>Sets the layer of the object</td>
    </tr>
    <tr>
      <td>void setLayerVisible(int layer, boolean visible)</td>
      <td style="text-align: center;">3.2</td>
      <td>Shows or hides the all objects in the given layer</td>
    </tr>
    <tr>
      <td>void {{Key|setLineStyle|blue}}(物件名, 樣式編號)</td>
      <td style="text-align: center;">3.2</td>
      <td>設定線條樣式：0 - 實線，1 - 長虛線，2 - 短虛線，3 - 點虛線，4 - 長點虛線。</td>
    </tr>
    <tr>
      <td>void {{Key|setLineThickness|blue}}(物件名, 厚度)</td>
      <td style="text-align: center;">3.2</td>
      <td>設定物件（線、圓等）的厚度，值從 {{Key|1 ~ 13}}。</td>
    </tr>
    <tr>
      <td>void setPointStyle(String objName, int style)</td>
      <td style="text-align: center;">3.2</td>
      <td>Sets the style of points (-1 default, 0 filled circle, 1 circle, 2 cross, 3 plus, 4 filled diamond, 5 unfilled diamond, 6 triangle (north), 7 triangle (south), 8 triangle (east), 9 triangle (west))</td>
    </tr>
    <tr>
      <td>void setPointSize(String objName, int size)</td>
      <td style="text-align: center;">3.2</td>
      <td>Sets the size of a point (from 1 to 9)</td>
    </tr>
    <tr>
      <td>void setFilling(String objName, double filling)</td>
      <td style="text-align: center;">3.2</td>
      <td>Sets the filling of an object (from 0 to 1)</td>
    </tr>
    <tr>
      <td>String getPNGBase64(double exportScale, boolean transparent, double DPI)</td>
      <td style="text-align: center;">4.0</td>
      <td>Returns Graphics View 1 as a base64-encoded String<br>eg var str = ggbApplet.getPNGBase64(1, true, 72);      </td>
    </tr>
    <tr>
      <td>boolean writePNGtoFile(String filename, double exportScale, boolean transparent, double DPI)
</td>
      <td style="text-align: center;">4.0</td>
      <td>Exports Graphics View 1 to a .PNG file '''(signed applets only)''' <br>
eg var success = ggbApplet.writePNGtoFile("c:\\test.png", 1, false, 300);      </td>
    </tr>
    <tr>
      <td>boolean isIndependent(String objName)
</td>
      <td style="text-align: center;">4.0</td>
      <td> checks if '''objName''' is independent      </td>
    </tr>
   <tr>
      <td>boolean isMoveable(String objName)
</td>
      <td style="text-align: center;">4.0</td>
      <td> checks if '''objName''' is is moveable</td>
    </tr>
   <tr>
      <td>String getBase64()
</td>
      <td style="text-align: center;">4.0</td>
      <td> Gets the current construction as a base64-encoded .ggb file</td>
    </tr>
      <td>void setBase64(String)
</td>
      <td style="text-align: center;">4.0</td>
      <td> Sets the current construction from a base64-encoded .ggb file</td>
</table>

=設定動態效果=
<table style="width: 100%;" class="pretty">
    <tr>
      <th>函數</th>
      <th style="text-align: center;">版本</th>
      <th>說明</th>
    </tr>
    <tr>
      <td>{{Key|setAnimating|blue}}</td>
      <td style="text-align: center;">3.2</td>
      <td>格式：setAnimating( 物件名, 啟動動畫? )<br>{{note|設定物件要不要啟動動畫效果。}}{{Example|1=<code>setAnimating("A", {{Key|true|red}})</code>}}{{Warning|光使用此函數並不能使物件產生動畫效果，必須搭配 {{Key|startAnimation}}() 才行！}}</td>
    </tr>
       <tr>
      <td>{{Key|setAnimationSpeed|blue}}</td>
      <td style="text-align: center;">3.2</td>
      <td>格式：setAnimationSpeed(物件名, 速度){{note|設定物件的動畫速度。}}</td>
    </tr>
  <tr>
      <td>{{Key|startAnimation}}</td>
      <td style="text-align: center;">3.2</td>
      <td>格式：startAnimation(){{note|正式啟動動畫功能。注意：只有用過 setAnimating() 設定過的物件才會動喔！}}</td>
    </tr>
    <tr>
      <td>void stopAnimation()</td>
      <td style="text-align: center;">3.2</td>
      <td>Stops animation for all objects with the animating flag set, see setAnimating()</td>
    </tr>	
   <tr>
      <td>boolean isAnimationRunning()</td>
      <td style="text-align: center;">3.2</td>
      <td>Returns whether automatic animation is currently running.</td>
    </tr>	
</table>

= Getting the state of objects =

<table style="width: 100%;" class="pretty">
    <tr>
      <th>Method Signature</th>
      <th style="text-align: center;">Since</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>double getXcoord(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the cartesian x-coord of the object with the given name.
Note: returns 0 if the object is not a point or a vector.</td>
    </tr>
    <tr>
      <td>double getYcoord(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the cartesian y-coord of the object with the given name.
Note: returns 0 if the object is not a point or a vector.</td>
    </tr>
    <tr>
      <td>double getValue(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Returns the double value of the object with the given name (e.g. length of segment, area of polygon). Note: returns 1 for a boolean object with value true. Otherwise 0 is returned.<br>
      </td>
    </tr>
    <tr>
      <td>String getColor(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the color of the object with the given name as a hex string, e.g. "#FF0000" for red. Note that the hex string always starts with # and contains no lower case letters.</td>
    </tr>
    <tr>
      <td> boolean getVisible(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Returns true or false depending on whether the object is visible in the Graphics View. Returns false if the object does not exist.</td>
    </tr>
    <tr>
      <td> boolean getVisible(String objName, int view)</td>
      <td style="text-align: center;">4.2</td>
      <td>Returns true or false depending on whether the object is visible in Graphics View 'view' (1 or 2). Returns false if the object does not exist.</td>
    </tr>
    <tr>
      <td> String getValueString(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the value of the object with the given name as a string.</td>
    </tr>
    <tr>
      <td>String getDefinitionString(String objName) </td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the definition of the object with the given name as a string.</td>
    </tr>
    <tr>
      <td>String getCommandString(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the command of the object with the given name as a string.</td>
    </tr>
    <tr>
      <td>String getObjectType(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the type of the given object as a string (like "point", "line", "circle", etc.).</td>
    </tr>
    <tr>
      <td>boolean exists(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns whether an object with the given name exists in the construction.</td>
    </tr>
    <tr>
      <td>boolean isDefined(String objName)</td>
      <td style="text-align: center;">2.7</td>
      <td>Returns whether the given object's value is valid at the moment.</td>
    </tr>
    <tr>
      <td>String [] getAllObjectNames()<br>
      <small style="font-style: italic; font-weight: bold;">Deprecated since 3.0</small> </td>
      <td style="text-align: center;">2.7</td>
      <td>Returns an array with all object names in the construction.
Note: using arrays in JavaScript causes problems with some browsers. Use getObjectNumber() and getObjectName() instead.</td>
    </tr>
    <tr>
      <td>int getObjectNumber()</td>
      <td style="text-align: center;">3.0</td>
      <td>Returns the number of objects in the construction.</td>
    </tr>
  <tr>
      <td>String getObjectName(int i)</td>
      <td style="text-align: center;">3.0</td>
      <td>Returns the name of the n-th object of the construction.</td>
    </tr>
  <tr>
      <td>String getLayer(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Returns the layer of the object.</td>
    </tr>
    <tr>
      <td>int getLineStyle(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Gets the line style for the object (0 to 4)</td>
    </tr>
    <tr>
      <td>int getLineThickness(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Gets the thickness of the line (1 to 13)</td>
    </tr>
    <tr>
      <td>int getPointStyle(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Gets the style of points (-1 default, 0 filled circle, 1 circle, 2 cross, 3 plus, 4 filled diamond, 5 unfilled diamond, 6 triangle (north), 7 triangle (south), 8 triangle (east), 9 triangle (west))</td>
    </tr>
    <tr>
      <td>int getPointSize(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Gets the size of a point (from 1 to 9)</td>
    </tr>
    <tr>
      <td>double getFilling(String objName)</td>
      <td style="text-align: center;">3.2</td>
      <td>Gets the filling of an object (from 0 to 1)</td>
    </tr>
</table>

= 繪圖區指令 =

<table style="width: 100%;" class="pretty">
   <tr>
      <th>函數</th>
      <th style="text-align: center;">版本</th>
      <th style="font-weight: bold;">說明</th>
    </tr>
    <tr>
      <td>void {{Key|setMode|blue}}( int [[參考:工具編號|工具編號]] )</td>
      <td style="text-align: center;">2.7</td>
      <td>設定繪圖區要使用的工具<br />
請參閱：[[參考:工具編號|工具編號]] 與 [[參考:Applet_參數|applet 參數]]中的「showToolBar」、「customToolBar」參數</td>
    </tr>
    <tr>
      <td>void openFile(String strURL)</td>
      <td style="text-align: center;">2.7</td>
      <td>Opens a construction from a&nbsp; file (given as absolute or relative URL string)</td>
    </tr>
    <tr>
      <td>void reset()</td>
      <td style="text-align: center;">2.7</td>
      <td>Reloads the initial construction (given in filename parameter) of this applet.<br>
      </td>
   </tr>
   <tr>
      <td>void refreshViews()</td>
      <td style="text-align: center;">2.7</td>
      <td>Refreshs all views. Note: this clears all traces in the graphics window.</td>
    </tr>
    <tr>
      <td>void setOnTheFlyPointCreationActive(boolean flag)<br>
      </td>
      <td style="text-align: center;">3.2</td>
      <td>Turns on the fly creation of points in graphics view on (true) or off (false). Note: this is useful if you don't want tools to have the side effect of creating points. For example, when this flag is set to false, the tool "line through two points" will not create points on the fly when you click on the background of the graphics view.</td>
    </tr>
    <tr>
      <td>void hideCursorWhenDragging(boolean flag)<br>
      </td>
      <td style="text-align: center;">3.2</td>
      <td>Hides (true) or shows (false) the mouse cursor (pointer) when dragging an object to change the construction. </td>
    </tr>
    <tr>
      <td>void setRepaintingActive(boolean flag)<br>
      </td>
      <td style="text-align: center;">2.7</td>
      <td>Turns the repainting of this applet on (true) or off (false).
Note: use this method for efficient repainting when you invoke several methods.</td>
    </tr>
    <tr>
      <td>void setErrorDialogsActive(boolean flag)</td>
      <td style="text-align: center;">3.0</td>
      <td>Turns showing of error dialogs on (true) or off (false). Note: this is especially useful together with evalCommand().</td>
    </tr>
    <tr>
      <td>void setCoordSystem(double xmin, double xmax, double ymin, double ymax)</td>
      <td style="text-align: center;">3.0</td>
      <td>Sets the Cartesian coordinate system of the graphics window.</td>
    </tr>
    <tr>
      <td>void setAxesVisible(boolean xAxis, boolean yAxis)</td>
      <td style="text-align: center;">3.0</td>
      <td>Shows or hides the x- and y-axis of the coordinate system in the graphics window.</td>
    </tr>
    <tr>
      <td>void setGridVisible(boolean flag) </td>
      <td style="text-align: center;">3.0</td>
      <td>Shows or hides the coordinate grid in the graphics window.</td>
    </tr>
</table>

=由 Applet 下達 JavaScript 指令=

下表的指令讓我們可以從 Applet 中的物件所產生的「事件」，下達一般的 JavaScript 指令。
當使用這些指令時，請記得一定要在<code><applet></code>標籤的最後面加入 {{Key|MAYSCRIPT|blue}} 這個屬性才行。例如：

*<code><applet name="ggbApplet" code="geogebra.GeoGebraApplet" codebase="." archive="geogebra.jar" width="500" height="250" {{Key|MAYSCRIPT|blue}}></code>

反過來說，如果我們只是要使用 <code>document.ggbApplet</code> 的物件方法去操控 Applet 中的物件時，這個 {{Key|MAYSCRIPT|blue}} 屬性就不需要設定了。

For example, these methods can be used to:
* monitor user actions (see [http://www.geogebra.org/source/program/applet/geogebra_applet_java2javascript.htm java2javascript example])
* communicate between two GeoGebra applets (see [http://www.geogebra.org/source/program/applet/geogebra_applet_java2java.htm java2java example])
<table style="width: 100%;" class="pretty">
 <tr>
 <th>函數</th>
 <th style="text-align: center;">版本</th>
 <th style="font-weight: bold;">說明</th>
 </tr>
 <tr>
 <td>void registerAddListener(String JSFunctionName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Registers a JavaScript function as an <span style="font-weight: bold;">add</span> listener for the applet's construction. Whenever a new object is created in the GeoGebraApplet's construction, the JavaScript function <span style="font-style: italic;">JSFunctionName</span> is called using the name of the newly created object as its single argument. <br>
<span style="font-style: italic;">Example</span>: First, register a listening JavaScript function:<br>
<div style="margin-left: 40px;"><span style="font-family: monospace;">ggbApplet.registerAddListener("myAddListenerFunction");</span> <br>
 </div>
When an object "A" is created, the GeoGebra Applet will call the Javascript function<br>
 <div style="margin-left: 40px;"><span style="font-family: monospace;">myAddListenerFunction("</span><span style="font-family: monospace;">A");<br>
 </span></div>
 </td>
 </tr>
 <tr>
 <td>void unregisterAddListener(String objName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Removes a previously registered add listener, see <span style="font-style: italic;">registerAddListener()</span></td>
 </tr>
 <tr>
 <td>void registerRemoveListener(String JSFunctionName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Registers a JavaScript function as a <span style="font-weight: bold;">remove</span> listener for the applet's construction. Whenever an object is deleted from the GeoGebraApplet's construction, the JavaScript function <span style="font-style: italic;">JSFunctionName</span> is called using the name of the deleted object as its single argument. Note: when a construction is cleared, remove is not called for every single object, see registerClearListener().<br>
<span style="font-style: italic;">Example</span>: First, register a listening JavaScript function:<br>
<div style="margin-left: 40px;"><span style="font-family: monospace;">ggbApplet.registerRemoveListener("myRemoveListenerFunction");</span> </div>
When the object "A" is deleted, the GeoGebra Applet will call the Javascript function<br>
 <div style="margin-left: 40px;"><span style="font-family: monospace;">myRemoveListenerFunction</span><span style="font-family: monospace;">("</span><span style="font-family: monospace;">A");<br>
 </span></div>
 </td>
 </tr>
 <tr>
 <td>void unregisterRemoveListener(String objName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Removes a previously registered remove listener, see <span style="font-style: italic;">registerRemoveListener()</span></td>
 </tr>
 <tr>
 <td>void registerUpdateListener(String JSFunctionName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Registers a JavaScript function as a <span style="font-weight: bold;">update</span> listener for the applet's construction. Whenever any object is updated in the GeoGebraApplet's construction, the JavaScript function <span style="font-style: italic;">JSFunctionName</span>is called using the name of the updated object as its single argument. Note: when you only want to listen for the updates of a single object use registerObjectUpdateListener() instead.<br>
<span style="font-style: italic;">Example</span>: First, register a listening JavaScript function:<br>
<div style="margin-left: 40px;"><span style="font-family: monospace;">ggbApplet.registerUpdateListener("myUpdateListenerFunction");</span> </div>
When the object "A" is updated, the GeoGebra Applet will call the Javascript function<br>
 <div style="margin-left: 40px;"><span style="font-family: monospace;">myUpdateListenerFunction</span><span style="font-family: monospace;">("</span><span style="font-family: monospace;">A");<br>
 </span></div>
 </td>
 </tr>
 <tr>
 <td>void unregisterUpdateListener(String objName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Removes a previously registered update listener, see <span style="font-style: italic;">registerUpdateListener()</span></td>
 </tr>
 <tr>
 <td>void {{Key|registerObjectUpdateListener|blue}}(物件名, 函數名)</td>
 <td style="text-align: center;">3.0</td>
 <td>設定當某物件的屬性有所變更時的處理程序。例如：如果設定<br />
*<code>document.ggbApplet.{{Key|registerObjectUpdateListener|blue}}("A", "updateCoords")</code><br />

則當物件 A 有所變更時，便會執行 <code>updateCoords("A")</code> 這個程序。
</td>
</tr>
<tr>
 <td>void unregisterObjectUpdateListener(String objName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Removes a previously registered object update listener of the object with the given name, see <span style="font-style: italic;">registerObjectUpdateListener()</span></td>
 </tr>
 <tr>
 <td>void registerRenameListener(String JSFunctionName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Registers a JavaScript function as a <span style="font-weight: bold;">rename</span> listener for the applet's construction. Whenever an object is renamed in the GeoGebraApplet's construction, the JavaScript function <span style="font-style: italic;">JSFunctionName</span> is called using the old name and the new name of the renamed object as its two arguments. <br>
<span style="font-style: italic;">Example</span>: First, register a listening JavaScript function:<br>
<div style="margin-left: 40px;"><span style="font-family: monospace;">ggbApplet.registerRenameListener("myRenameListenerFunction");</span> </div>
When an object "A" is renamed to "B", the GeoGebra Applet will call the Javascript function<br>
 <div style="margin-left: 40px;"><span style="font-family: monospace;">myRenameListenerFunction</span><span style="font-family: monospace;">("</span><span style="font-family: monospace;">A", "B");<br>
 </span></div>
 </td>
 </tr>
 <tr>
 <td>void unregisterRenameListener(String objName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Removes a previously registered rename listener, see <span style="font-style: italic;">registerRenameListener()</span></td>
 </tr>
 <tr>
 <td>void registerClearListener(String JSFunctionName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Registers a JavaScript function as a <span style="font-weight: bold;">clear</span> listener for the applet's construction. Whenever the construction in the GeoGebraApplet is cleared (i.e. all objects are removed), the JavaScript function JSFunctionName is called using no arguments. Note: all update listeners are unregistered when a construction is cleared. See registerUpdateListener() and registerRemoveListener().<br>
<span style="font-style: italic;">Example</span>: First, register a listening JavaScript function:<br>
<div style="margin-left: 40px;"><span style="font-family: monospace;">ggbApplet.registerClearListener("myClearListenerFunction");</span> </div>
When the construction is cleared (i.e. after reseting a construction or opening a new construction file), the GeoGebra Applet will call the Javascript function<br>
 <div style="margin-left: 40px;"><span style="font-family: monospace;">myClearListenerFunction</span><span style="font-family: monospace;">(</span><span style="font-family: monospace;">);</span></div>
 </td>
 </tr>
 <tr>
 <td>void unregisterClearListener(String JSFunctionName)</td>
 <td style="text-align: center;">3.0</td>
 <td>Removes a previously registered clear listener, see <span style="font-style: italic;">registerClearListener()</span></td>
 </tr>
</table>

= GeoGebra's XML format =

With these methods you can set everything in a construction (see [[Reference:Xml|XML Reference]] ).
<table style="width: 100%;" class="pretty">
    <tr>
      <th>Method Signature</th>
      <th style="text-align: center;">Since</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>void evalXML(String xmlString) </td>
      <td style="text-align: center;">2.7</td>
      <td>Evaluates the given XML string and changes the current construction. Note: the construction is NOT cleared before evaluating the XML string.
      </td>
    </tr>
    <tr>
      <td>void setXML(String xmlString) </td>
      <td style="text-align: center;">2.7</td>
      <td>Evaluates the given XML string and changes the current construction. Note: the construction is cleared before evaluating the XML string. This method could be used to load constructions.
      </td>
    </tr>
    <tr>
      <td>String getXML()<br>
      </td>
      <td style="text-align: center;">2.7</td>
      <td>Returns the current construction in GeoGebra's XML format. This method could be used to save constructions.<br>
      </td>
    </tr>
  <tr>
      <td>String getXML(String objName)<br>
      </td>
      <td style="text-align: center;">3.2</td>
      <td>Returns the GeoGebra XML string for the given object, i.e. only the &lt;element&gt; tag is returned.
      </td>
    </tr>
<tr>
      <td>String getAlgorithmXML(String objName)<br>
      </td>
      <td style="text-align: center;">3.2</td>
      <td>For a dependent GeoElement objName the XML string of the parent algorithm and all its output objects is returned. For a free GeoElement objName "" is returned. 
      </td>
    </tr>
</table>

= Miscellaneous =


<table style="width: 100%;" class="pretty">
    <tr>
      <th>Method Signature</th>
      <th>Since</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>String evalMathPiper(String string) </td>
      <td style="text-align: center;">3.2</td>
      <td>Passes the string to MathPiper and returns the result as a String.<br>
<b>Removed in GeoGebra 4.0 and will replaced with evalGeoGebraCAS() in GeoGebra 4.2</b>
      </td>
    </tr>
    <tr>
      <td>String getIPAddress()</td>
      <td style="text-align: center;">3.2</td>
      <td>Returns the IP address of the local computer as a String eg "192.168.0.4"
      </td>
    </tr>
    <tr>
      <td>String getHostname() </td>
      <td style="text-align: center;">3.2</td>
      <td>Returns the hostname of the local computer as a String
      </td>
    </tr>
    <tr>
      <td>void debug(String string) </td>
      <td style="text-align: center;">3.2</td>
      <td>Prints the string to the Java Console
      </td>
    </tr>

</table>
[[en:Reference:JavaScript]]
[[Category:參考]]