Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
0f3adc69
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看板
未验证
提交
0f3adc69
编写于
10月 19, 2022
作者:
O
openharmony_ci
提交者:
Gitee
10月 19, 2022
浏览文件
操作
浏览文件
下载
差异文件
!10772 错误码整改文档格式修改
Merge pull request !10772 from ZhengJiangliang/master
上级
c8b2d295
ef50001a
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
131 addition
and
111 deletion
+131
-111
zh-cn/application-dev/reference/apis/js-apis-display.md
zh-cn/application-dev/reference/apis/js-apis-display.md
+9
-5
zh-cn/application-dev/reference/apis/js-apis-screen.md
zh-cn/application-dev/reference/apis/js-apis-screen.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-window.md
zh-cn/application-dev/reference/apis/js-apis-window.md
+57
-68
zh-cn/application-dev/reference/errorcodes/errorcode-display.md
...application-dev/reference/errorcodes/errorcode-display.md
+21
-12
zh-cn/application-dev/reference/errorcodes/errorcode-window.md
.../application-dev/reference/errorcodes/errorcode-window.md
+42
-24
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-display.md
浏览文件 @
0f3adc69
...
...
@@ -89,8 +89,9 @@ getDefaultDisplaySync(): Display
**示例:**
```
js
let
displayClass
=
null
;
try
{
let
displayClass
=
display
.
getDefaultDisplaySync
();
displayClass
=
display
.
getDefaultDisplaySync
();
}
catch
(
exception
)
{
console
.
error
(
'
Failed to obtain the default display object. Code:
'
+
JSON
.
stringify
(
exception
));
};
...
...
@@ -208,8 +209,9 @@ try {
return
;
};
let
ret
=
undefined
;
try
{
let
ret
=
display
.
hasPrivateWindow
(
displayClass
.
id
);
ret
=
display
.
hasPrivateWindow
(
displayClass
.
id
);
}
catch
(
exception
)
{
console
.
error
(
'
Failed to check has privateWindow or not. Code:
'
+
JSON
.
stringify
(
exception
));
};
...
...
@@ -243,7 +245,7 @@ on(type: 'add'|'remove'|'change', callback: Callback<number>): void
```
js
let
callback
=
(
data
)
=>
{
console
.
info
(
'
Listening enabled. Data:
'
+
JSON
.
stringify
(
data
));
}
}
;
try
{
display
.
on
(
"
add
"
,
callback
);
}
catch
(
exception
)
{
...
...
@@ -445,8 +447,9 @@ getCutoutInfo(callback: AsyncCallback<CutoutInfo>): void
**示例:**
```
js
let
displayClass
=
null
;
try
{
let
displayClass
=
display
.
getDefaultDisplaySync
();
displayClass
=
display
.
getDefaultDisplaySync
();
}
catch
(
exception
)
{
console
.
error
(
'
Failed to obtain the default display object. Code:
'
+
JSON
.
stringify
(
exception
));
};
...
...
@@ -483,8 +486,9 @@ getCutoutInfo(): Promise<CutoutInfo>
**示例:**
```
js
let
displayClass
=
null
;
try
{
let
displayClass
=
display
.
getDefaultDisplaySync
();
displayClass
=
display
.
getDefaultDisplaySync
();
}
catch
(
exception
)
{
console
.
error
(
'
Failed to obtain the default display object. Code:
'
+
JSON
.
stringify
(
exception
));
};
...
...
zh-cn/application-dev/reference/apis/js-apis-screen.md
浏览文件 @
0f3adc69
...
...
@@ -39,7 +39,7 @@ getAllScreens(callback: AsyncCallback<Array<Screen>>): void
**示例:**
```
js
var
screenClass
=
null
;
let
screenClass
=
null
;
screen
.
getAllScreens
((
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to get all screens . Cause:
'
+
JSON
.
stringify
(
err
));
...
...
@@ -75,7 +75,7 @@ getAllScreens(): Promise<Array<Screen>>
**示例:**
```
js
var
screenClass
=
null
;
let
screenClass
=
null
;
let
promise
=
screen
.
getAllScreens
();
promise
.
then
((
data
)
=>
{
screenClass
=
data
[
0
];
...
...
zh-cn/application-dev/reference/apis/js-apis-window.md
浏览文件 @
0f3adc69
...
...
@@ -592,6 +592,7 @@ minimizeAll(id: number): Promise<void>
import
display
from
'
@ohos.display
'
import
window
from
'
@ohos.window
'
let
displayClass
=
null
;
try
{
displayClass
=
display
.
getDefaultDisplaySync
();
}
catch
(
exception
)
{
...
...
@@ -923,7 +924,7 @@ create(ctx: BaseContext, id: string, type: WindowType, callback: AsyncCallback&l
```
js
let
windowClass
=
null
;
window
.
create
(
this
.
context
,
'
alertWindow
'
,
window
.
WindowType
.
TYPE_SYSTEM_ALERT
,
(
err
,
data
)
=>
{
window
.
create
(
this
.
context
,
'
alertWindow
'
,
window
.
WindowType
.
TYPE_SYSTEM_ALERT
,
(
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to create the window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -998,13 +999,13 @@ find(id: string, callback: AsyncCallback<Window>): void
```
js
let
windowClass
=
null
;
window
.
find
(
'
alertWindow
'
,
(
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to find the Window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
windowClass
=
data
;
console
.
info
(
'
Succeeded in finding the window. Data:
'
+
JSON
.
stringify
(
data
));
window
.
find
(
'
alertWindow
'
,
(
err
,
data
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to find the Window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
windowClass
=
data
;
console
.
info
(
'
Succeeded in finding the window. Data:
'
+
JSON
.
stringify
(
data
));
});
```
...
...
@@ -1038,7 +1039,7 @@ find(id: string): Promise<Window>
let
windowClass
=
null
;
let
promise
=
window
.
find
(
'
alertWindow
'
);
promise
.
then
((
data
)
=>
{
windowClass
=
data
;
windowClass
=
data
;
console
.
info
(
'
Succeeded in finding the window. Data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
err
)
=>
{
console
.
error
(
'
Failed to find the Window. Cause:
'
+
JSON
.
stringify
(
err
));
...
...
@@ -1105,7 +1106,7 @@ getTopWindow(): Promise<Window>
let
windowClass
=
null
;
let
promise
=
window
.
getTopWindow
();
promise
.
then
((
data
)
=>
{
windowClass
=
data
;
windowClass
=
data
;
console
.
info
(
'
Succeeded in obtaining the top window. Data:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
err
)
=>
{
console
.
error
(
'
Failed to obtain the top window. Cause:
'
+
JSON
.
stringify
(
err
));
...
...
@@ -2348,25 +2349,20 @@ loadContent(path: string, storage: LocalStorage, callback: AsyncCallback<void
**示例:**
```
ts
class
myAbility
extends
Ability
{
storage
:
LocalStorage
onWindowStageCreate
(
windowStage
)
{
this
.
storage
=
new
LocalStorage
();
this
.
storage
.
setOrCreate
(
'
storageSimpleProp
'
,
121
);
console
.
log
(
'
onWindowStageCreate
'
);
try
{
windowStage
.
loadContent
(
'
pages/page2
'
,
this
.
storage
,(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in loading the content.
'
);
});
}
catch
(
exception
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
exception
));
};
}
}
let
storage
=
new
LocalStorage
();
storage
.
setOrCreate
(
'
storageSimpleProp
'
,
121
);
console
.
log
(
'
onWindowStageCreate
'
);
try
{
windowClass
.
loadContent
(
'
pages/page2
'
,
storage
,
(
err
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in loading the content.
'
);
});
}
catch
(
exception
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
exception
));
};
```
### loadContent<sup>9+</sup>
...
...
@@ -2404,26 +2400,19 @@ loadContent(path: string, storage: LocalStorage): Promise<void>
**示例:**
```
ts
class
myAbility
extends
Ability
{
storage
:
LocalStorage
onWindowStageCreate
(
windowStage
)
{
this
.
storage
=
new
LocalStorage
();
this
.
storage
.
setOrCreate
(
'
storageSimpleProp
'
,
121
);
console
.
log
(
'
onWindowStageCreate
'
);
let
windowClass
=
null
;
try
{
let
promise
=
windowStage
.
loadContent
(
'
pages/page2
'
,
this
.
storage
);
promise
.
then
(()
=>
{
windowClass
=
data
;
console
.
info
(
'
Succeeded in loading the content.
'
);
}).
catch
((
err
)
=>
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
err
));
});
}
catch
(
exception
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
exception
));
};
}
}
let
storage
=
new
LocalStorage
();
storage
.
setOrCreate
(
'
storageSimpleProp
'
,
121
);
console
.
log
(
'
onWindowStageCreate
'
);
try
{
let
promise
=
windowClass
.
loadContent
(
'
pages/page2
'
,
storage
);
promise
.
then
(()
=>
{
console
.
info
(
'
Succeeded in loading the content.
'
);
}).
catch
((
err
)
=>
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
err
));
});
}
catch
(
exception
)
{
console
.
error
(
'
Failed to load the content. Cause:
'
+
JSON
.
stringify
(
exception
));
};
```
### isWindowShowing<sup>9+</sup>
...
...
@@ -2719,7 +2708,7 @@ off(type: 'screenshot', callback?: Callback<void>): void
```
js
let
callback
=
()
=>
{
console
.
info
(
'
screenshot happened
'
);
}
}
;
try
{
windowClass
.
on
(
'
screenshot
'
,
callback
);
}
catch
(
exception
)
{
...
...
@@ -3745,13 +3734,13 @@ snapshot(callback: AsyncCallback<image.PixelMap>): void
**示例:**
```
js
windowClass
.
snapshot
((
err
,
data
)
=>
{
windowClass
.
snapshot
((
err
,
pixelMap
)
=>
{
if
(
err
.
code
)
{
console
.
error
(
'
Failed to snapshot window. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Succeeded in snapshotting window. Pixel bytes number:
'
+
pixelMap
.
getPixelBytesNumber
());
data
.
release
();
// PixelMap使用完后及时释放内存
pixelMap
.
release
();
// PixelMap使用完后及时释放内存
});
```
...
...
@@ -3855,9 +3844,9 @@ scale(scaleOptions: ScaleOptions): void
let
obj
:
window
.
ScaleOptions
=
{
x
:
2.0
,
y
:
1.0
,
pivotX
=
0.5
;
pivotY
=
0.5
;
}
pivotX
:
0.5
,
pivotY
:
0.5
}
;
try
{
windowClass
.
scale
(
obj
);
}
catch
(
exception
)
{
...
...
@@ -3897,9 +3886,9 @@ let obj : window.RotateOptions = {
x
:
1.0
,
y
:
1.0
,
z
:
45.0
,
pivotX
=
0.5
;
pivotY
=
0.5
;
}
pivotX
:
0.5
,
pivotY
:
0.5
}
;
try
{
windowClass
.
rotate
(
obj
);
}
catch
(
exception
)
{
...
...
@@ -3939,7 +3928,7 @@ let obj : window.TranslateOptions = {
x
:
100.0
,
y
:
0.0
,
z
:
0.0
}
}
;
try
{
windowClass
.
translate
(
obj
);
}
catch
(
exception
)
{
...
...
@@ -3977,7 +3966,7 @@ try {
```
js
let
controller
=
windowClass
.
getTransitionController
();
// 获取属性转换控制器
controller
.
animationForHidden
=
(
context
:
window
.
TransitionContext
)
=>
{
let
toWindow
=
context
.
toWindow
let
toWindow
=
context
.
toWindow
;
animateTo
({
duration
:
1000
,
// 动画时长
tempo
:
0.5
,
// 播放速率
...
...
@@ -3993,7 +3982,7 @@ controller.animationForHidden = (context : window.TransitionContext) => {
x
:
100.0
,
y
:
0.0
,
z
:
0.0
}
}
;
toWindow
.
translate
(
obj
);
// 设置动画过程中的属性转换
console
.
info
(
'
toWindow translate end
'
);
}
...
...
@@ -4108,7 +4097,7 @@ setBackdropBlurStyle(blurStyle: BlurStyle): void
```
js
try
{
windowClass
.
setBackdropBlurStyle
(
window
.
Blur
Typ
e
.
THIN
);
windowClass
.
setBackdropBlurStyle
(
window
.
Blur
Styl
e
.
THIN
);
}
catch
(
exception
)
{
console
.
error
(
'
Failed to set backdrop blur style. Cause:
'
+
JSON
.
stringify
(
exception
));
};
...
...
@@ -6525,7 +6514,7 @@ completeTransition(isCompleted: boolean): void
```
js
let
controller
=
windowClass
.
getTransitionController
();
controller
.
animationForShown
=
(
context
:
window
.
TransitionContext
)
=>
{
let
toWindow
=
context
.
toWindow
let
toWindow
=
context
.
toWindow
;
animateTo
({
duration
:
1000
,
// 动画时长
tempo
:
0.5
,
// 播放速率
...
...
@@ -6538,7 +6527,7 @@ controller.animationForShown = (context : window.TransitionContext) => {
x
:
100.0
,
y
:
0.0
,
z
:
0.0
}
}
;
toWindow
.
translate
(
obj
);
console
.
info
(
'
toWindow translate end
'
);
}
...
...
@@ -6577,7 +6566,7 @@ animationForShown(context: TransitionContext): void
```
js
let
controller
=
windowClass
.
getTransitionController
();
controller
.
animationForShown
=
(
context
:
window
.
TransitionContext
)
=>
{
let
toWindow
=
context
.
toWindow
let
toWindow
=
context
.
toWindow
;
animateTo
({
duration
:
1000
,
// 动画时长
tempo
:
0.5
,
// 播放速率
...
...
@@ -6593,7 +6582,7 @@ controller.animationForShown = (context : window.TransitionContext) => {
x
:
100.0
,
y
:
0.0
,
z
:
0.0
}
}
;
toWindow
.
translate
(
obj
);
console
.
info
(
'
toWindow translate end
'
);
}
...
...
@@ -6623,7 +6612,7 @@ animationForHidden(context: TransitionContext): void
```
js
let
controller
=
windowClass
.
getTransitionController
();
controller
.
animationForHidden
=
(
context
:
window
.
TransitionContext
)
=>
{
let
toWindow
=
context
.
toWindow
let
toWindow
=
context
.
toWindow
;
animateTo
({
duration
:
1000
,
// 动画时长
tempo
:
0.5
,
// 播放速率
...
...
@@ -6639,7 +6628,7 @@ controller.animationForHidden = (context : window.TransitionContext) => {
x
:
100.0
,
y
:
0.0
,
z
:
0.0
}
}
;
toWindow
.
translate
(
obj
);
console
.
info
(
'
toWindow translate end
'
);
}
...
...
zh-cn/application-dev/reference/errorcodes/errorcode-display.md
浏览文件 @
0f3adc69
# 屏幕错误码
## 1400001 无效虚拟屏
### 错误信息
**错误信息**
<br>
This is invalid screen.
### 错误描述
**错误描述**
<br>
当操作无效的虚拟屏时,会报此错误码。
### 可能原因
**可能原因**
1.
虚拟屏未创建。
2.
虚拟屏已销毁。
### 处理步骤
**处理步骤**
1.
在操作虚拟屏前,检查该虚拟屏是否已经存在,确保已创建该虚拟屏。
2.
在操作虚拟屏前,检查虚拟屏是否已被销毁,确保其未被销毁,再进行相关操作。
## 1400002 无权限操作
### 错误信息
**错误信息**
<br>
This operation is not access.
### 错误描述
**错误描述**
<br>
当对无操作权限的对象进行操作时,会报此错误码。
### 可能原因
**可能原因**
<br>
操作了其它进程的虚拟屏对象。
### 处理步骤
**处理步骤**
<br>
请检查是否非法操作了别的进程的对象,删除相关非法操作。
## 1400003 系统服务工作异常
### 错误信息
**错误信息**
<br>
This window manager service work abnormally.
### 错误描述
**错误描述**
<br>
当系统服务工作异常时,会报此错误码。
### 可能原因
**可能原因**
1.
窗口内部服务没有正常启动。
2.
底层图形图像合成渲染异常。
### 处理步骤
**处理步骤**
<br>
系统服务内部工作异常,请稍候重试,或者重启设备尝试。
zh-cn/application-dev/reference/errorcodes/errorcode-window.md
浏览文件 @
0f3adc69
# 窗口错误码
## 1300001 重复操作
### 错误信息
**错误信息**
<br>
This is repeat operation.
### 错误描述
**错误描述**
<br>
当进行某些重复操作时,系统会报此错误码。
### 可能原因
**可能原因**
<br>
创建的窗口已经存在时,再次创建该窗口会报错。
### 处理步骤
**处理步骤**
<br>
在创建窗口前,检查该窗口是否已经存在,确保为首次创建该窗口。
## 1300002 窗口状态异常
### 错误信息
**错误信息**
<br>
This window state is abnormal.
### 错误描述
**错误描述**
<br>
当窗口状态异常,如已被销毁时,操作该窗口,会报此错误码。
### 可能原因
**可能原因**
<br>
操作窗口时,该窗口已被销毁。
### 处理步骤
**处理步骤**
<br>
在对窗口进行操作前,检查该窗口是否存在,确保其未被销毁,再进行相关操作。
## 1300003 系统服务工作异常
### 错误信息
**错误信息**
<br>
This window manager service work abnormally.
### 错误描述
**错误描述**
<br>
当系统服务工作异常时,会报此错误码。
### 可能原因
**可能原因**
<br>
窗口内部服务没有正常启动。
### 处理步骤
**处理步骤**
<br>
系统服务内部工作异常,请稍候重试,或者重启设备尝试。
## 1300004 无权限操作
### 错误信息
**错误信息**
<br>
This operation is not access.
### 错误描述
**错误描述**
<br>
当对无操作权限的对象进行操作时,会报此错误码。
### 可能原因
**可能原因**
<br>
操作了其它进程的窗口对象。
### 处理步骤
**处理步骤**
<br>
请检查是否非法操作了别的进程的对象,删除相关操作。
## 1300005 WindowStage异常
### 错误信息
**错误信息**
<br>
This window stage is abnormal.
### 错误描述
**错误描述**
<br>
当WindowStage异常,如已被销毁时,操作该WindowStage,会报此错误码。
### 可能原因
**可能原因**
<br>
操作WindowStage时,该WindowStage已被销毁。
### 处理步骤
**处理步骤**
<br>
在对WindowStage进行操作前,检查该WindowStage是否存在,若已被销毁,请释放该WindowStage下的窗口。
## 1300006 窗口上下文异常
### 错误信息
**错误信息**
<br>
This window context is abnormal.
### 错误描述
**错误描述**
<br>
当窗口上下文异常,如已被销毁时,操作该窗口上下文,会报此错误码。
### 可能原因
**可能原因**
<br>
操作窗口上下文时,该窗口上下文已被销毁。
### 处理步骤
**处理步骤**
<br>
在对窗口上下文进行操作前,检查该窗口上下文是否存在,确保其未被销毁,再进行相关操作。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录