未验证 提交 36a696a5 编写于 作者: O openharmony_ci 提交者: Gitee

!19915 【轻量级 PR】:update zh-cn/application-dev/windowmanager/application-window-stage.md.

Merge pull request !19915 from 葛亚芳/N/A
......@@ -53,16 +53,18 @@
`Stage`模型下,应用主窗口由`UIAbility`创建并维护生命周期。在`UIAbility``onWindowStageCreate`回调中,通过`WindowStage`获取应用主窗口,即可对其进行属性设置等操作。还可以在应用配置文件中设置应用主窗口的属性,如最大窗口宽度maxWindowWidth等,详见[module.json5配置文件](../quick-start/module-configuration-file.md#abilities标签)
### 开发步骤
1. 获取应用主窗口。
通过`getMainWindow`接口获取应用主窗口。
2. 设置主窗口属性。
可设置主窗口的背景色、亮度值、是否可触等多个属性,开发者可根据需要选择对应的接口。本示例以设置“是否可触”属性为例。
3. 为主窗口加载对应的目标页面。
通过`loadContent`接口加载主窗口的目标页面。
```ts
......@@ -101,32 +103,35 @@ export default class EntryAbility extends UIAbility {
};
```
## 设置应用子窗口
开发者可以按需创建应用子窗口,如弹窗等,并对其进行属性设置等操作。
### 开发步骤
1. 创建应用子窗口。
通过`createSubWindow`接口创建应用子窗口。
2. 设置子窗口属性。
子窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置窗口背景色、亮度等属性。
3. 加载显示子窗口的具体内容。
通过`setUIContent``showWindow`接口加载显示子窗口的具体内容。
4. 销毁子窗口。
当不再需要某些子窗口时,可根据具体实现逻辑,使用`destroyWindow`接口销毁子窗口。
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
let windowStage_ = null;
let sub_windowClass = null;
let windowStage_ = null;
let sub_windowClass = null;
export default class EntryAbility extends UIAbility {
export default class EntryAbility extends UIAbility {
showSubWindow() {
// 1.创建应用子窗口。
windowStage_.createSubWindow("mySubWindow", (err, data) => {
......@@ -191,9 +196,8 @@ export default class EntryAbility extends UIAbility {
// 开发者可以在适当的时机,如子窗口上点击关闭按钮等,销毁子窗口。并不一定需要在onWindowStageDestroy调用,这里仅作展示
this.destroySubWindow();
}
};
```
};
```
## 体验窗口沉浸式能力
......@@ -203,19 +207,23 @@ export default class EntryAbility extends UIAbility {
### 开发步骤
1. 获取应用主窗口。
通过`getMainWindow`接口获取应用主窗口。
2. 实现沉浸式效果。有以下两种方式:
- 方式一:调用`setWindowSystemBarEnable`接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。
- 方式二:调用`setWindowLayoutFullScreen`接口,设置应用主窗口为全屏布局;然后调用`setWindowSystemBarProperties`接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。
3. 加载显示沉浸式窗口的具体内容。
通过`loadContent`接口加载沉浸式窗口的具体内容。
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
export default class EntryAbility extends UIAbility {
export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) {
// 1.获取应用主窗口。
let windowClass = null;
......@@ -269,9 +277,8 @@ export default class EntryAbility extends UIAbility {
console.info('Succeeded in loading the content.');
});
}
};
```
};
```
## 设置悬浮窗
......@@ -281,6 +288,7 @@ export default class EntryAbility extends UIAbility {
### 开发步骤
1. 申请权限。
创建`WindowType.TYPE_FLOAT`即悬浮窗类型的窗口,需要在`module.json5`文件的`requestPermissions`对象中配置`ohos.permission.SYSTEM_FLOAT_WINDOW`权限。更多配置信息详见[module.json5配置文件](../quick-start/module-configuration-file.md)
> **说明:**
......@@ -306,23 +314,26 @@ export default class EntryAbility extends UIAbility {
```
2. 创建悬浮窗。
通过`window.createWindow`接口创建悬浮窗类型的窗口。
3. 对悬浮窗进行属性设置等操作。
悬浮窗窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置悬浮窗背景色、亮度等属性。
4. 加载显示悬浮窗的具体内容。
通过`setUIContent``showWindow`接口加载显示悬浮窗的具体内容。
5. 销毁悬浮窗。
当不再需要悬浮窗时,可根据具体实现逻辑,使用`destroyWindow`接口销毁悬浮窗。
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
export default class EntryAbility extends UIAbility {
export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) {
// 2. 创建悬浮窗。
let windowClass = null;
......@@ -375,8 +386,9 @@ export default class EntryAbility extends UIAbility {
});
});
}
};
```
};
```
## 相关实例
针对window开发(Stage模型),有以下相关实例可供参考:
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册