未验证 提交 ce0c2b14 编写于 作者: 葛亚芳 提交者: Gitee

update zh-cn/application-dev/windowmanager/application-window-stage.md.

Signed-off-by: N葛亚芳 <geyafang@huawei.com>
上级 b5f4a099
...@@ -30,7 +30,7 @@ ...@@ -30,7 +30,7 @@
上述场景涉及的常用接口如下表所示。更多API说明请参见[API参考](../reference/apis/js-apis-window.md) 上述场景涉及的常用接口如下表所示。更多API说明请参见[API参考](../reference/apis/js-apis-window.md)
| 实例名 | 接口名 | 描述 | | 实例名 | 接口名 | 描述 |
| -------- | -------- | -------- | | -------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| WindowStage | getMainWindow(callback: AsyncCallback&lt;Window&gt;): void | 获取`WindowStage`实例下的主窗口。<br/>此接口仅可在`Stage`模型下使用。 | | WindowStage | getMainWindow(callback: AsyncCallback&lt;Window&gt;): void | 获取`WindowStage`实例下的主窗口。<br/>此接口仅可在`Stage`模型下使用。 |
| WindowStage | loadContent(path: string, callback: AsyncCallback&lt;void&gt;): void | 为当前`WindowStage`的主窗口加载具体页面。<br/>此接口仅可在`Stage`模型下使用。 | | WindowStage | loadContent(path: string, callback: AsyncCallback&lt;void&gt;): void | 为当前`WindowStage`的主窗口加载具体页面。<br/>此接口仅可在`Stage`模型下使用。 |
| WindowStage | createSubWindow(name: string, callback: AsyncCallback&lt;Window&gt;): void | 创建子窗口。<br/>此接口仅可在`Stage`模型下使用。 | | WindowStage | createSubWindow(name: string, callback: AsyncCallback&lt;Window&gt;): void | 创建子窗口。<br/>此接口仅可在`Stage`模型下使用。 |
...@@ -111,22 +111,20 @@ export default class EntryAbility extends UIAbility { ...@@ -111,22 +111,20 @@ export default class EntryAbility extends UIAbility {
1. 创建应用子窗口。 1. 创建应用子窗口。
通过`createSubWindow`接口创建应用子窗口。 通过`createSubWindow`接口创建应用子窗口。
2. 设置子窗口属性。 2. 设置子窗口属性。
子窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置窗口背景色、亮度等属性。 子窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置窗口背景色、亮度等属性。
3. 加载显示子窗口的具体内容。 3. 加载显示子窗口的具体内容。
通过`setUIContent``showWindow`接口加载显示子窗口的具体内容。 通过`setUIContent``showWindow`接口加载显示子窗口的具体内容。
4. 销毁子窗口。 4. 销毁子窗口。
当不再需要某些子窗口时,可根据具体实现逻辑,使用`destroyWindow`接口销毁子窗口。 当不再需要某些子窗口时,可根据具体实现逻辑,使用`destroyWindow`接口销毁子窗口。
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
let windowStage_ = null;
let sub_windowClass = null;
let windowStage_ = null; export default class EntryAbility extends UIAbility {
let sub_windowClass = null;
export default class EntryAbility extends UIAbility {
showSubWindow() { showSubWindow() {
// 1.创建应用子窗口。 // 1.创建应用子窗口。
windowStage_.createSubWindow("mySubWindow", (err, data) => { windowStage_.createSubWindow("mySubWindow", (err, data) => {
...@@ -191,9 +189,8 @@ export default class EntryAbility extends UIAbility { ...@@ -191,9 +189,8 @@ export default class EntryAbility extends UIAbility {
// 开发者可以在适当的时机,如子窗口上点击关闭按钮等,销毁子窗口。并不一定需要在onWindowStageDestroy调用,这里仅作展示 // 开发者可以在适当的时机,如子窗口上点击关闭按钮等,销毁子窗口。并不一定需要在onWindowStageDestroy调用,这里仅作展示
this.destroySubWindow(); this.destroySubWindow();
} }
}; };
``` ```
## 体验窗口沉浸式能力 ## 体验窗口沉浸式能力
...@@ -204,18 +201,16 @@ export default class EntryAbility extends UIAbility { ...@@ -204,18 +201,16 @@ export default class EntryAbility extends UIAbility {
1. 获取应用主窗口。 1. 获取应用主窗口。
通过`getMainWindow`接口获取应用主窗口。 通过`getMainWindow`接口获取应用主窗口。
2. 实现沉浸式效果。有以下两种方式: 2. 实现沉浸式效果。有以下两种方式:
- 方式一:应用主窗口为全屏窗口时,调用`setWindowSystemBarEnable`接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。 - 方式一:应用主窗口为全屏窗口时,调用`setWindowSystemBarEnable`接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。
- 方式二:调用`setWindowLayoutFullScreen`接口,设置应用主窗口为全屏布局;然后调用`setWindowSystemBarProperties`接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。 - 方式二:调用`setWindowLayoutFullScreen`接口,设置应用主窗口为全屏布局;然后调用`setWindowSystemBarProperties`接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。
3. 加载显示沉浸式窗口的具体内容。 3. 加载显示沉浸式窗口的具体内容。
通过`loadContent`接口加载沉浸式窗口的具体内容。 通过`loadContent`接口加载沉浸式窗口的具体内容。
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
// 1.获取应用主窗口。 // 1.获取应用主窗口。
let windowClass = null; let windowClass = null;
...@@ -269,8 +264,8 @@ export default class EntryAbility extends UIAbility { ...@@ -269,8 +264,8 @@ export default class EntryAbility extends UIAbility {
console.info('Succeeded in loading the content.'); console.info('Succeeded in loading the content.');
}); });
} }
}; };
``` ```
## 设置悬浮窗 ## 设置悬浮窗
...@@ -318,15 +313,17 @@ export default class EntryAbility extends UIAbility { ...@@ -318,15 +313,17 @@ export default class EntryAbility extends UIAbility {
当不再需要悬浮窗时,可根据具体实现逻辑,使用`destroyWindow`接口销毁悬浮窗。 当不再需要悬浮窗时,可根据具体实现逻辑,使用`destroyWindow`接口销毁悬浮窗。
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window'; import window from '@ohos.window';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
// 2. 创建悬浮窗。 // 2. 创建悬浮窗。
let windowClass = null; let windowClass = null;
let config = {name: "floatWindow", windowType: window.WindowType.TYPE_FLOAT, ctx: this.context}; let config = {
name: "floatWindow", windowType: window.WindowType.TYPE_FLOAT, ctx: this.context
};
window.createWindow(config, (err, data) => { window.createWindow(config, (err, data) => {
if (err.code) { if (err.code) {
console.error('Failed to create the floatWindow. Cause: ' + JSON.stringify(err)); console.error('Failed to create the floatWindow. Cause: ' + JSON.stringify(err));
...@@ -375,8 +372,9 @@ export default class EntryAbility extends UIAbility { ...@@ -375,8 +372,9 @@ export default class EntryAbility extends UIAbility {
}); });
}); });
} }
}; };
``` ```
## 相关实例 ## 相关实例
针对window开发(Stage模型),有以下相关实例可供参考: 针对window开发(Stage模型),有以下相关实例可供参考:
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册