Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
2ee5778a
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
2ee5778a
编写于
6月 19, 2023
作者:
O
openharmony_ci
提交者:
Gitee
6月 19, 2023
浏览文件
操作
浏览文件
下载
差异文件
!19916 【轻量级 PR】:update zh-cn/application-dev/windowmanager/application-window-stage.md.
Merge pull request !19916 from 葛亚芳/N/A
上级
0e237eb5
e24d5671
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
20 addition
and
5 deletion
+20
-5
zh-cn/application-dev/windowmanager/application-window-stage.md
...application-dev/windowmanager/application-window-stage.md
+20
-5
未找到文件。
zh-cn/application-dev/windowmanager/application-window-stage.md
浏览文件 @
2ee5778a
...
...
@@ -24,7 +24,6 @@
以下分别介绍具体开发方式。
## 接口说明
上述场景涉及的常用接口如下表所示。更多API说明请参见
[
API参考
](
../reference/apis/js-apis-window.md
)
。
...
...
@@ -53,16 +52,18 @@
在
`Stage`
模型下,应用主窗口由
`UIAbility`
创建并维护生命周期。在
`UIAbility`
的
`onWindowStageCreate`
回调中,通过
`WindowStage`
获取应用主窗口,即可对其进行属性设置等操作。还可以在应用配置文件中设置应用主窗口的属性,如最大窗口宽度maxWindowWidth等,详见
[
module.json5配置文件
](
../quick-start/module-configuration-file.md#abilities标签
)
。
### 开发步骤
1.
获取应用主窗口。
通过
`getMainWindow`
接口获取应用主窗口。
2.
设置主窗口属性。
可设置主窗口的背景色、亮度值、是否可触等多个属性,开发者可根据需要选择对应的接口。本示例以设置“是否可触”属性为例。
3.
为主窗口加载对应的目标页面。
通过
`loadContent`
接口加载主窗口的目标页面。
```
ts
...
...
@@ -101,21 +102,26 @@ export default class EntryAbility extends UIAbility {
};
```
## 设置应用子窗口
开发者可以按需创建应用子窗口,如弹窗等,并对其进行属性设置等操作。
### 开发步骤
1.
创建应用子窗口。
通过
`createSubWindow`
接口创建应用子窗口。
2.
设置子窗口属性。
子窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置窗口背景色、亮度等属性。
3.
加载显示子窗口的具体内容。
通过
`setUIContent`
和
`showWindow`
接口加载显示子窗口的具体内容。
4.
销毁子窗口。
当不再需要某些子窗口时,可根据具体实现逻辑,使用
`destroyWindow`
接口销毁子窗口。
```
ts
...
...
@@ -200,11 +206,17 @@ export default class EntryAbility extends UIAbility {
### 开发步骤
1.
获取应用主窗口。
通过
`getMainWindow`
接口获取应用主窗口。
2.
实现沉浸式效果。有以下两种方式:
-
方式一:应用主窗口为全屏窗口时,调用
`setWindowSystemBarEnable`
接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。
-
方式二:调用
`setWindowLayoutFullScreen`
接口,设置应用主窗口为全屏布局;然后调用
`setWindowSystemBarProperties`
接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。
3.
加载显示沉浸式窗口的具体内容。
通过
`loadContent`
接口加载沉浸式窗口的具体内容。
```
ts
...
...
@@ -267,7 +279,6 @@ export default class EntryAbility extends UIAbility {
};
```
## 设置悬浮窗
悬浮窗可以在已有的任务基础上,创建一个始终在前台显示的窗口。即使创建悬浮窗的任务退至后台,悬浮窗仍然可以在前台显示。通常悬浮窗位于所有应用窗口之上;开发者可以创建悬浮窗,并对悬浮窗进行属性设置等操作。
...
...
@@ -276,6 +287,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
)
。
> **说明:**
...
...
@@ -301,12 +313,15 @@ export default class EntryAbility extends UIAbility {
```
2.
创建悬浮窗。
通过
`window.createWindow`
接口创建悬浮窗类型的窗口。
3.
对悬浮窗进行属性设置等操作。
悬浮窗窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置悬浮窗背景色、亮度等属性。
4.
加载显示悬浮窗的具体内容。
通过
`setUIContent`
和
`showWindow`
接口加载显示悬浮窗的具体内容。
5.
销毁悬浮窗。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录