pyChariot.api.mainwin Since 25.4.1.1
小应用主窗口管理，主窗口状态管理与操作
show() Since 25.4.1.1
显示主窗口
javascript
await __A.mainwin.show();hide() Since 25.4.1.1
隐藏主窗口
| 返回值 | 说明 |
|---|---|
| string | 路径名称 |
javascript
await __A.mainwin.hide();getTitle() Since 25.4.1.1
获取当前小应用主窗口的窗口标题
| 返回值 | 说明 |
|---|---|
| string |
javascript
await __A.mainwin.getTitle();setTitle(title) Since 25.4.1.1
获取当前小应用主窗口的窗口标题
| 参数 | 类型 | 说明 |
|---|---|---|
| title | string | 窗口标题 |
javascript
await __A.mainwin.setTitle('新的窗口标题');getOnTop() Since 25.4.1.1
返回主窗口 on_top 状态（显示在最前面）
javascript
await __A.mainwin.getOnTop();setOnTop(on_top) Since 25.4.1.1
设置主窗口 on_top 状态（显示在最前面）
| 参数 | 类型 | 说明 |
|---|---|---|
| on_top | bool | 是否显示在最前面，默认为 true。 |
javascript
await __A.mainwin.setOnTop();javascript
await __A.mainwin.setOnTop(false);getX() Since 25.4.1.1
获取主窗口坐标 x 值。
| 返回值 | 说明 |
|---|---|
| number |
javascript
await __A.mainwin.getX();getY() Since 25.4.1.1
获取主窗口坐标 x 值。
| 返回值 | 说明 |
|---|---|
| number |
javascript
await __A.mainwin.getY();move(x, y) Since 25.4.1.1
移动小应用主窗口到指定坐标
| 参数 | 类型 | 说明 |
|---|---|---|
| x | number | |
| y | number |
javascript
// 主窗口向右下移动
x = await __A.mainwin.getX();
y = await __A.mainwin.getY();
await __A.mainwin.move(x + 2, y + 2);javascript
// 主窗口移动到屏幕左上角
await __A.mainwin.move(0, 0);getWidth() Since 25.4.1.1
获取主窗口宽度
| 返回值 | 说明 |
|---|---|
| number |
javascript
await __A.mainwin.getWidth();getHeight() Since 25.4.1.1
获取主窗口高度
| 返回值 | 说明 |
|---|---|
| number |
javascript
await __A.mainwin.getHeight();resize(width, height) Since 25.4.1.1
移动小应用主窗口到指定坐标
| 参数 | 类型 | 说明 |
|---|---|---|
| width | number | |
| height | number |
javascript
// 主窗口变大一些
width = await __A.mainwin.getWidth();
height = await __A.mainwin.getHeight();
__A.mainwin.resize(width + 2, height + 2);restore() Since 25.4.1.1
还原主窗口
javascript
await __A.mainwin.restore();toggleFullscreen() Since 25.4.1.1
切换主窗口全屏显示状态
javascript
await __A.mainwin.toggleFullscreen();maximize() Since 25.4.1.1
主窗口最大化
javascript
await __A.mainwin.maximize();minimize() Since 25.4.1.1
主窗口最小化
javascript
await __A.mainwin.minimize();loadUrl(url) Since 25.4.1.1
在主窗口中加载指定的 url
| 参数 | 类型 | 说明 |
|---|---|---|
| url | string |
javascript
await __A.mainwin.loadUrl('https://chanix.github.io/pyChariot/');loadHtml(htmlcode) Since 25.4.1.1
在主窗口中加载指定的 url
| 参数 | 类型 | 说明 |
|---|---|---|
| htmlcode | string |
javascript
await __A.mainwin.loadHtml('<h1>This is dynamically loaded HTML</h1>');loadCss(css) Since 25.4.1.1
在主窗口中加载自定义 CSS
| 参数 | 类型 | 说明 |
|---|---|---|
| css | string |
javascript
await __A.mainwin.loadCss('body { background: red !important; }');getStatus() Since 25.4.2.1
获得主窗口常用信息
| 返回值 | 说明 |
|---|---|
| object |
主窗口常用信息，包括以下字段：
- x: 坐标 x；
- y: 坐标 y；
- width: 宽度；
- height: 高度；
- title: 窗口标题；
- ontop: 是否总是显示在最前面；
- state: 窗口状态：
- 0 最小化
- 1 正常
- 2 最大化
- 其他：未知状态
javascript
await __A.mainwin.getInfo();reload() Since 25.4.15.1
重新装载浏览器窗口当前网址
javascript
await __A.mainwin.reload();