# web.rest.aiChat.settingForm 库模块帮助文档

<details>  <summary>说明</summary>  <p>

web.rest.aiChat.settingForm 继承自 win.form ，并扩展了以下属性与事件：

### web.rest.aiChat.settingForm 对象属性

- userAgent 属性

	用于指定 AI 请求模型列表时 HTTP 客户端使用的 User-Agent 请求头。

### web.rest.aiChat.settingForm 对象事件

1. onSelChange 事件

	~~~aardio
	onSelChange = function(selIndex,configItem){

	}
	~~~

	在配置界面切换助手时触发。

	- 参数 selIndex 为当前选项索引。
	- 参数 configItem 为当前配置项。

2. onSelChange 事件

	~~~aardio
	onHyperlink = function(apiUrl,apiKey){

	}
	~~~

	点击超链接时触发。

	- 参数 apiUrl 为当前接口 URL。
	- 参数 apiKey 为当前接口 API key 。

	如果 onHyperlink 返回 true 则默认打开选中 API 地址的对应厂商主页。

	可通过配置窗体的 hyperlink1 属性访问超链接控件。  
	hyperlink1 默认为隐藏状态，可通过 hyperlink1 控件的 hide , disabled 属性控制其显示状态。
	可在 onSelChange 事件中动态设置 hyperlink1 控件是否显示。
	hyperlink1 的 text 属性默认为空值，可根据需要修改。

</p></details>

## web.rest.aiChat 成员列表 <a id="web.rest.aiChat" href="#web.rest.aiChat">&#x23;</a>

### web.rest.aiChat.settingForm <a id="web.rest.aiChat.settingForm" href="#web.rest.aiChat.settingForm">&#x23;</a>
用于创建设置 AI 接口配置的窗口。  
此窗口用到了 FontAwesome 图标 `\uF067`，`\uF044`，`\uF1F8`，  
调用者必须提前导入 fonts.fontAwesome 或精简的 fontAwesome 字体库。

### web.rest.aiChat.settingForm(parentForm,configFile) <a id="web.rest.aiChat.settingForm" href="#web.rest.aiChat.settingForm">&#x23;</a>
窗口类。  
- 参数 @parentForm 可指定父窗体对象，也可指定空值（null ）。  
- 参数 @configFile 必须指定配置文件对象（fsys.table 对象或 fsys.config 对象的成员）。  

参数 @configFile 可选预先指定以下字段：  
- title: 自定义窗口标题  
- f1Title: 自定义复选框 1 的标题，自动绑定定配置值 configFile.f1（flag1 的缩写）。  
如果不指定 f1Title 则不显示 自定义复选框 1 。  
- f1MultiSelect: 如果为 true 则允许多个助手启用 f1，否则为单选切换模式，默认为 false。  
- allowKatex: 是否允许启用数学公式（Win10 以下总是禁用）。  
- hyperlink1Title: 指定超链接标题，指定则默认显示 hyperlink1 控件。  
- itemNames：字符串数组，指定 AI 助手名称列表。  
- itemData：AI 接口配置数组，必须与 temNames 的元素一一对应。  
- urls: 字符串数组，接口 URL 显示的默认接口 URL 列表。  

[返回对象:winform](https://www.aardio.com/zh-cn/doc/library-reference/win/ui/_.html#winform)