docs: update gui api

Author: xiaoqch

docs/apis/GuiAPI/Form.md

@@ -13,7 +13,7 @@ for a specific player object `pl`, the following form interfaces are available:
 
 A modal form contains a title, a text display, and two buttons.
 
-`pl.sendModalForm(title,content,confirmButton,cancelButton,callback,forUpdating)`
+`pl.sendModalForm(title,content,confirmButton,cancelButton,callback[,forUpdating])`
 
 - Parameters:
     - title : `String`  
@@ -27,7 +27,7 @@ A modal form contains a title, a text display, and two buttons.
     - callback : `Function`  
       Function called after player clicks a button.
     - forUpdating : `Boolean`
-      Whether the form is sent for updating.
+      (Optional parameter) Whether the form is sent for updating. The default value is false, meaning it is not for form updating.
 - Return value: The ID of the sent form.
 - Return value type: `Integer`
     - If the return value is `Null`, it means the sending failed.
@@ -51,7 +51,7 @@ set.
 Due to the relatively complex content setup of buttons, it is recommended to use the form builder API in the next
 section to better accomplish this task.
 
-`pl.sendSimpleForm(title,content,buttons,images,callback,forUpdating)`
+`pl.sendSimpleForm(title,content,buttons,images,callback[,forUpdating])`
 
 - Parameters:
     - title : `String`  
@@ -65,7 +65,7 @@ section to better accomplish this task.
     - callback : `Function`  
       The function called after the player clicks a button.
     - forUpdating : `Boolean`
-      Whether the form is sent for updating.
+      (Optional parameter) Whether the form is sent for updating. The default value is false, meaning it is not for form updating.
 - Return value: The sent form ID.
 - Return value type: `Integer`
     - If the return value is `Null`, it means the sending failed.
@@ -95,15 +95,15 @@ Custom forms can contain rich custom controls.
 Since the relevant JSON definition format is relatively complex, it is recommended to use the form builder API in the
 next section to better accomplish this task.
 
-`pl.sendCustomForm(json,callback,forUpdating)`
+`pl.sendCustomForm(json,callback[,forUpdating])`
 
 - Parameters:
     - json : `String`  
       Custom form JSON string.
     - callback : `Function`  
       Callback function to be called after the player submits the form.
     - forUpdating : `Boolean`
-      Whether the form is sent for updating.
+      (Optional parameter) Whether the form is sent for updating. The default value is false, meaning it is not for form updating.
 - Return value: The sent form ID.
 - Return value type: `Integer`
     - If the return value is Null, it means the sending failed.

docs/apis/GuiAPI/Form.zh.md

@@ -12,7 +12,7 @@
 
 模式表单包含一个标题、一个文本显示框以及两个按钮
 
-`pl.sendModalForm(title,content,confirmButton,cancelButton,callback,forUpdating)`
+`pl.sendModalForm(title,content,confirmButton,cancelButton,callback[,forUpdating])`
 
 - 参数：
     - title : `String`  
@@ -26,7 +26,7 @@
     - callback : `Function`  
       玩家点击按钮之后被调用的回调函数。
     - forUpdating : `Boolean`
-      是否为表单更新
+      （可选参数）是否为表单更新，默认值为false，即非表单更新
 - 返回值：发送的表单ID
 - 返回值类型：`Integer`
     - 如果返回值为`Null`，则代表发送失败
@@ -48,7 +48,7 @@
 普通表单包含一个标题、一个文本显示框以及若干按钮，可以设置按钮上显示的图标  
 由于按钮的内容设置相对复杂，建议使用下一节的表单构建器API更好地完成这项任务。
 
-`pl.sendSimpleForm(title,content,buttons,images,callback,forUpdating)`
+`pl.sendSimpleForm(title,content,buttons,images,callback[,forUpdating])`
 
 - 参数：
     - title : `String`  
@@ -62,7 +62,7 @@
     - callback : `Function`  
       玩家点击按钮之后被调用的回调函数。
     - forUpdating : `Boolean`
-      是否为表单更新。
+      （可选参数）是否为表单更新，默认值为false，即非表单更新
 - 返回值：发送的表单ID
 - 返回值类型：`Integer`
     - 如果返回值为`Null`，则代表发送失败
@@ -91,15 +91,15 @@
 自定义表单可以包含丰富的自定义控件。  
 由于相关JSON定义格式相对复杂，建议使用下一节的表单构建器API更好地完成这项任务。
 
-`pl.sendCustomForm(json,callback,forUpdating)`
+`pl.sendCustomForm(json,callback[,forUpdating])`
 
 - 参数：
     - json : `String`  
       自定义表单json字符串
     - callback : `Function`  
       玩家提交表单之后被调用的回调函数。
     - forUpdating : `Boolean`
-      是否为表单更新。
+      （可选参数）是否为表单更新，默认值为false，即非表单更新
 - 返回值：发送的表单ID
 - 返回值类型：`Integer`
     - 如果返回值为`Null`，则代表发送失败

docs/apis/GuiAPI/FormBuilder.md

@@ -101,7 +101,7 @@ For a player object `pl`, using the function:
     - callback : `Function`  
       Callback function to be called after the player interacts with the form element.
     - forUpdating : `Boolean`
-      Whether the form is sent for updating.
+      (Optional parameter) Whether the form is sent for updating. The default value is false, meaning it is not for form updating.
 - Return value: The sent form ID.
 - Return value type: `Integer`
     - If the return value is `Null`, it means the sending failed.
@@ -256,6 +256,16 @@ For a specific form object `fm`, the following functions are available:
 - Return value: The processed form object (for other operations in the chain).
 - Return value type: `CustomForm`
 
+#### Set the Text of the Submit Button
+
+`fm.setSubmitButton(text)`
+
+- Parameters:
+    - text : `String`  
+      Text of the submit button.
+- Return value: The processed form object (for other operations in the chain).
+- Return value type: `CustomForm`
+
 ### Send Form
 
 Finally, when everything is in place, you can send the configured form object to the player and listen for player
@@ -265,15 +275,15 @@ are called when there is player interaction, without fighting.
 
 For a player object `pl`, using the function:
 
-`pl.sendForm(fm,callback,forUpdating)`
+`pl.sendForm(fm,callback[,forUpdating])`
 
 - Parameters:
     - fm : `CustomForm`  
       Configured custom form object.
     - callback : `Function`  
       Callback function to be called after the player submits the form.
     - forUpdating : `Boolean`
-      Whether the form is sent for updating.
+      (Optional parameter) Whether the form is sent for updating. The default value is false, meaning it is not for form updating.
 - Return value: The sent form ID.
 - Return value type: `Integer`
     - If the return value is `Null`, it means the sending failed.

docs/apis/GuiAPI/FormBuilder.zh.md

@@ -93,15 +93,15 @@
 
 对于某个玩家对象`pl`，使用函数：
 
-`pl.sendForm(fm,callback,forUpdating)`
+`pl.sendForm(fm,callback[,forUpdating])`
 
 - 参数：
     - fm : `SimpleForm`  
       配置好的表单对象
     - callback : `Function`  
       玩家与表单元素互动之后被调用的回调函数。
     - forUpdating : `Boolean`
-      是否为表单更新
+      （可选参数）是否为表单更新，默认值为false，即非表单更新
 - 返回值：发送的表单ID
 - 返回值类型：`Integer`
     - 如果返回值为`Null`，则代表发送失败
@@ -255,22 +255,32 @@ reason可能会是`null`.
 - 返回值：处理完毕的表单对象（便于连锁进行其他操作）
 - 返回值类型：`CustomForm`
 
+#### 设置提交按钮的文本
+
+`fm.setSubmitButton(text)`
+
+- 参数：
+    - text : `String`  
+      提交按钮的文本
+- 返回值：处理完毕的表单对象（便于连锁进行其他操作）
+- 返回值类型：`CustomForm`
+
 ### 发送表单
 
 最后，在一切就绪之后，你可以将配置好的表单对象发送给玩家，并监听玩家的互动消息  
 表单对象可以被反复发送，每次发送都会返回一个不同的表单ID，并在有玩家互动时调用各自设置的回调函数，不会打架。
 
 对于某个玩家对象`pl`，使用函数：
 
-`pl.sendForm(fm,callback,forUpdating)`
+`pl.sendForm(fm,callback[,forUpdating])`
 
 - 参数：
     - fm : `CustomForm`  
       配置好的自定义表单对象
     - callback : `Function`  
       玩家提交表单之后被调用的回调函数。
     - forUpdating : `Boolean`
-      是否为表单更新
+      （可选参数）是否为表单更新，默认值为false，即非表单更新
 - 返回值：发送的表单ID
 - 返回值类型：`Integer`
     - 如果返回值为`Null`，则代表发送失败