Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
3dd1d730
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看板
未验证
提交
3dd1d730
编写于
12月 08, 2022
作者:
葛
葛亚芳
提交者:
Gitee
12月 08, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/windowmanager/application-window-fa.md.
Signed-off-by:
N
葛亚芳
<
geyafang@huawei.com
>
上级
8b975ed1
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
41 addition
and
61 deletion
+41
-61
zh-cn/application-dev/windowmanager/application-window-fa.md
zh-cn/application-dev/windowmanager/application-window-fa.md
+41
-61
未找到文件。
zh-cn/application-dev/windowmanager/application-window-fa.md
浏览文件 @
3dd1d730
...
...
@@ -22,21 +22,19 @@
| 实例名 | 接口名 | 描述 |
| -------- | -------- | -------- |
| window静态方法 | create(id: string, type: WindowType, callback: AsyncCallback
<
Window
>
): void | 创建子窗口。
<br>
此接口仅可在
`FA`
模型下使用。 |
| window静态方法 | getTopWindow(callback: AsyncCallback
<
Window
>
): void | 获取当前应用内最后显示的窗口。
<br/>
此接口仅可在
`FA`
模型下使用。 |
| window静态方法 | find(id: string, callback: AsyncCallback
<
Window
>
): void | 查找
`id`
所对应的窗口。 |
| Window | loadContent(path: string, callback: AsyncCallback
<
void
>
): void | 为当前窗口加载具体页面内容。 |
| Window | moveTo(x: number, y: number, callback: AsyncCallback
<
void
>
): void | 移动当前窗口。 |
| Window | setBackgroundColor(color: string, callback: AsyncCallback
<
void
>
): void | 设置窗口的背景色。 |
| Window | setBrightness(brightness: number, callback: AsyncCallback
<
void
>
): void | 设置屏幕亮度值。 |
| Window | resetSize(width: number, height: number, callback: AsyncCallback
<
void
>
): void | 改变当前窗口大小。 |
| Window | setFullScreen(isFullScreen: boolean, callback: AsyncCallback
<
void
>
): void | 设置窗口是否全屏显示。 |
| Window | setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback
<
void
>
): void | 设置窗口布局是否为全屏布局。 |
| Window | setSystemBarEnable(names: Array
<
'status'\|'navigation'
>
): Promise
<
void
>
| 设置导航栏、状态栏是否显示。 |
| Window | setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback
<
void
>
): void | 设置窗口内导航栏、状态栏属性。
<br/>
`systemBarProperties`
:导航栏、状态栏的属性集合。 |
| Window | show(callback: AsyncCallback
\<
void>): void | 显示当前窗口。 |
| window静态方法 | createWindow(config: Configuration, callback: AsyncCallback
<Window>
): void | 创建子窗口。
<br/>
-
`config`
:创建窗口时的参数。 |
| window静态方法 | findWindow(id: string, callback: AsyncCallback
<
Window
>
): void | 查找
`id`
所对应的窗口。 |
| Window | SetUIContent(path: string, callback: AsyncCallback
<
void
>
): void | 为当前窗口加载具体页面内容。 |
| Window | moveWindowTo(x: number, y: number, callback: AsyncCallback
<
void
>
): void | 移动当前窗口。 |
| Window | setWindowBackgroundColor(color: string, callback: AsyncCallback
<
void
>
): void | 设置窗口的背景色。 |
| Window | setWindowBrightness(brightness: number, callback: AsyncCallback
<
void
>
): void | 设置屏幕亮度值。 |
| Window | resize(width: number, height: number, callback: AsyncCallback
<
void
>
): void | 改变当前窗口大小。 |
| Window | setWindowLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback
<
void
>
): void | 设置窗口布局是否为全屏布局。 |
| Window | setWindowSystemBarEnable(names: Array
<
'status'\|'navigation'
>
): Promise
<
void
>
| 设置导航栏、状态栏是否显示。 |
| Window | setWindowSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback
<
void
>
): void | 设置窗口内导航栏、状态栏属性。
<br/>
`systemBarProperties`
:导航栏、状态栏的属性集合。 |
| Window | showWindow(callback: AsyncCallback
\<
void>): void | 显示当前窗口。 |
| Window | on(type: 'touchOutside', callback: Callback
<
void
>
): void | 开启本窗口区域外的点击事件的监听。 |
| Window | destroy(callback: AsyncCallback
<
void
>
): void | 销毁当前窗口。 |
| Window | destroy
Window
(callback: AsyncCallback
<
void
>
): void | 销毁当前窗口。 |
## 设置应用子窗口
...
...
@@ -48,16 +46,16 @@
1.
创建/获取子窗口对象。
-
可以通过
`window.create`
接口创建子窗口。
-
可以通过
`window.getTopWindow`
来获取最后显示的窗口得到子窗口。
-
也可以通过
`window.find`
接口来查找已经创建的窗口从而得到子窗口。
```
js
-
可以通过
`window.createWindow`
接口创建子窗口。
-
也可以通过
`window.findWindow`
接口来查找已经创建的窗口从而得到子窗口。
```
js
import
window
from
'
@ohos.window
'
;
let
windowClass
=
null
;
// 方式一:创建子窗口。
window
.
create
(
"
subWindow
"
,
window
.
WindowType
.
TYPE_APP
,
(
err
,
data
)
=>
{
let
config
=
{
name
:
"
subWindow
"
,
windowType
:
window
.
WindowType
.
TYPE_APP
,
ctx
:
this
.
context
};
window
.
createWindow
(
config
,
(
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to create the subWindow. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -65,17 +63,8 @@
console
.
info
(
'
Succeeded in creating subWindow. Data:
'
+
JSON
.
stringify
(
data
));
windowClass
=
data
;
});
// 方式二:获取子窗口。
window
.
getTopWindow
((
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to get the subWindow. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in getting subWindow. Data:
'
+
JSON
.
stringify
(
data
));
windowClass
=
data
;
});
// 方式三:查找得到子窗口。
window
.
find
(
"
subWindow
"
,
(
err
,
data
)
=>
{
// 方式二:查找得到子窗口。
window
.
findWindow
(
"
subWindow
"
,
(
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to find the subWindow. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -91,7 +80,7 @@
```
js
// 移动子窗口位置。
windowClass
.
moveTo
(
300
,
300
,
(
err
)
=>
{
windowClass
.
move
Window
To
(
300
,
300
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to move the window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -99,7 +88,7 @@
console
.
info
(
'
Succeeded in moving the window.
'
);
});
// 改变子窗口大小。
windowClass
.
res
etSize
(
500
,
10
00
,
(
err
)
=>
{
windowClass
.
res
ize
(
500
,
5
00
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to change the window size. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -110,18 +99,18 @@
3.
加载显示子窗口的具体内容。
使用
`
loadContent`
和
`sh
ow`
接口加载显示子窗口的具体内容。
使用
`
SetUIContent`
和
`showWind
ow`
接口加载显示子窗口的具体内容。
```
js
// 为子窗口加载对应的目标页面。
windowClass
.
load
Content
(
"
pages/page2
"
,
(
err
)
=>
{
windowClass
.
SetUI
Content
(
"
pages/page2
"
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in loading the content.
'
);
// 显示子窗口。
windowClass
.
show
((
err
)
=>
{
windowClass
.
show
Window
((
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to show the window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -133,11 +122,11 @@
4.
销毁子窗口。
当不再需要某些子窗口时,可根据场景的具体实现逻辑,使用
`destroy`
接口销毁子窗口。
当不再需要某些子窗口时,可根据场景的具体实现逻辑,使用
`destroy
Window
`
接口销毁子窗口。
```
js
// 销毁子窗口。当不再需要某些子窗口时,可根据场景的具体实现逻辑,使用destroy接口销毁子窗口。
windowClass
.
destroy
((
err
)
=>
{
windowClass
.
destroy
Window
((
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to destroy the subwindow. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -160,14 +149,14 @@
>
> 沉浸式能力需要在成功获取应用主窗口对象的前提下进行。
>
> 确保应用内最后显示的窗口为主窗口,然后再使用`window.get
Top
Window`接口来获取得到主窗口。
> 确保应用内最后显示的窗口为主窗口,然后再使用`window.get
Last
Window`接口来获取得到主窗口。
```
js
import
window
from
'
@ohos.window
'
;
let
mainWindowClass
=
null
;
// 获取主窗口。
window
.
get
Top
Window
((
err
,
data
)
=>
{
window
.
get
Last
Window
((
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to get the subWindow. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -179,23 +168,14 @@
2.
实现沉浸式效果。有以下三种方式:
-
方式一:调用
`setFullScreen`
接口,设置应用主窗口为全屏显示,此时导航栏、状态栏将隐藏,从而达到沉浸式效果。
-
方式二:调用
`setSystemBarEnable`
接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。
-
方式三:调用
`setLayoutFullScreen`
接口,设置应用主窗口为全屏布局;然后调用
`setSystemProperties`
接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。
-
方式一:调用
`setWindowSystemBarEnable`
接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。
-
方式二:调用
`setWindowLayoutFullScreen`
接口,设置应用主窗口为全屏布局;然后调用
`setSystemProperties`
接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。
```
js
// 实现沉浸式效果。方式一:设置窗口全屏显示。
let
isFullScreen
=
true
;
mainWindowClass
.
setFullScreen
(
isFullScreen
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to enable the full-screen mode. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in enabling the full-screen mode.
'
);
});
// 实现沉浸式效果。方式二:设置导航栏、状态栏不显示。
// 实现沉浸式效果。方式一:设置导航栏、状态栏不显示。
let
names
=
[];
mainWindowClass
.
setSystemBarEnable
(
names
,
(
err
)
=>
{
mainWindowClass
.
set
Window
SystemBarEnable
(
names
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to set the system bar to be visible. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -203,9 +183,9 @@
console
.
info
(
'
Succeeded in setting the system bar to be visible.
'
);
});
// 实现沉浸式效果。
// 方式
三
:设置窗口为全屏布局,配合设置状态栏、导航栏的透明度、背景/文字颜色及高亮图标等属性,与主窗口显示保持协调一致。
// 方式
二
:设置窗口为全屏布局,配合设置状态栏、导航栏的透明度、背景/文字颜色及高亮图标等属性,与主窗口显示保持协调一致。
let
isLayoutFullScreen
=
true
;
mainWindowClass
.
setLayoutFullScreen
(
isLayoutFullScreen
,
(
err
)
=>
{
mainWindowClass
.
set
Window
LayoutFullScreen
(
isLayoutFullScreen
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to set the window layout to full-screen mode. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -219,7 +199,7 @@
statusBarContentColor
:
'
#ffffff
'
,
navigationBarContentColor
:
'
#ffffff
'
};
mainWindowClass
.
setSystemBarProperties
(
sysBarProps
,
(
err
)
=>
{
mainWindowClass
.
set
Window
SystemBarProperties
(
sysBarProps
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to set the system bar properties. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -227,21 +207,21 @@
console
.
info
(
'
Succeeded in setting the system bar properties.
'
);
});
```
3.
加载显示沉浸式窗口的具体内容。
使用
`
loadContent`
和
`sh
ow`
接口加载显示沉浸式窗口的具体内容。
使用
`
SetUIContent`
和
`showWind
ow`
接口加载显示沉浸式窗口的具体内容。
```
js
// 为沉浸式窗口加载对应的目标页面。
mainWindowClass
.
load
Content
(
"
pages/page3
"
,
(
err
)
=>
{
mainWindowClass
.
SetUI
Content
(
"
pages/page3
"
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in loading the content.
'
);
// 显示沉浸式窗口。
mainWindowClass
.
show
((
err
)
=>
{
mainWindowClass
.
show
Window
((
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to show the window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录