Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d17967aa
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
提交
d17967aa
编写于
7月 30, 2022
作者:
H
HelloCrease
提交者:
LiAn
7月 30, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
fixed
36769ad9
from
https://gitee.com/HelloCrease/docs/pulls/7483
update docs Signed-off-by:
N
HelloCrease
<
lian15@huawei.com
>
上级
2d693c9d
变更
3
显示空白变更内容
内联
并排
Showing
3 changed file
with
165 addition
and
165 deletion
+165
-165
zh-cn/application-dev/ability/context-userguide.md
zh-cn/application-dev/ability/context-userguide.md
+11
-11
zh-cn/application-dev/reference/apis/js-apis-Context.md
zh-cn/application-dev/reference/apis/js-apis-Context.md
+153
-153
zh-cn/application-dev/ui/ts-event-configuration.md
zh-cn/application-dev/ui/ts-event-configuration.md
+1
-1
未找到文件。
zh-cn/application-dev/ability/context-userguide.md
浏览文件 @
d17967aa
...
@@ -7,10 +7,10 @@
...
@@ -7,10 +7,10 @@
OpenHarmony的应用框架分为FA模型和Stage两种模型。对应存在两套Context机制适配两种应用框架模型,其中application/BaseContext属于通用的Context基类,里面包含一个属性stageMode,用来区分开发模型是FA还是Stage。
OpenHarmony的应用框架分为FA模型和Stage两种模型。对应存在两套Context机制适配两种应用框架模型,其中application/BaseContext属于通用的Context基类,里面包含一个属性stageMode,用来区分开发模型是FA还是Stage。
-
FA模型
-
FA模型
只有app/Context中的方法属于FA模型对应的Context。该模式下,应用级别的Context和Ability级别的Context都是该类型的实例,如果在应用级别的Context里面调用了Ability级别的方法,会产生错误。所以开发者需要注意Context实例所代表的实际含义。
只有app/Context中的方法属于FA模型对应的Context。该模式下,应用级别的Context和Ability级别的Context都是该类型的实例,如果在应用级别的Context里面调用了Ability级别的方法,会产生错误。所以开发者需要注意Context实例所代表的实际含义。
-
Stage模型
-
Stage模型
除了app/Context之外的Context都属于Stage模型,分别有application/Context、application/ApplicationContext、application/AbilityStageContext、application/ExtensionContext、application/AbilityContext、application/FormExtensionContext等Context。这些Context的介绍及使用方式将会在
[
Stage模型和Context详细介绍
](
#stage模型和context详细介绍
)
种进行说明。
除了app/Context之外的Context都属于Stage模型,分别有application/Context、application/ApplicationContext、application/AbilityStageContext、application/ExtensionContext、application/AbilityContext、application/FormExtensionContext等Context。这些Context的介绍及使用方式将会在
[
Stage模型和Context详细介绍
](
#stage模型和context详细介绍
)
种进行说明。


...
@@ -225,20 +225,21 @@ export default class MainAbility extends Ability {
...
@@ -225,20 +225,21 @@ export default class MainAbility extends Ability {
[
FormExtensionContext
](
/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
)
[
FormExtensionContext
](
/zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
)
### 在e
ts
页面中访问Context
### 在e
TS
页面中访问Context
Stage模型下,在Ability的
`onWindowStageCreate`
生命周期中,可以通过WindowStage的
`SetUIContent`
方法加载一个ets
页面。在一些场景中,需要在页面内获取Context调用相关API。
Stage模型下,在Ability的
`onWindowStageCreate`
生命周期中,可以通过WindowStage的
`SetUIContent`
方法加载一个eTS
页面。在一些场景中,需要在页面内获取Context调用相关API。
**获取方法**
**获取方法**
在ets页面中通过以下全局方法获取当前页面关联的Context。
在eTS页面中通过以下全局方法获取当前页面关联的Context。
|接口名|描述|
|:------|:------|
| 接口名 | 描述 |
|getContext(component: Object): Object|获取页面中component所关联的Context对象。|
| :------------------------------------ | :--------------------------- |
| getContext(component: Object): Object | 获取页面中component所关联的Context对象。 |
**示例**
**示例**
```
t
ypescript
```
t
s
// MainAbility.ts
// MainAbility.ts
import
Ability
from
'
@ohos.application.Ability
'
import
Ability
from
'
@ohos.application.Ability
'
...
@@ -264,7 +265,7 @@ export default class MainAbility extends Ability {
...
@@ -264,7 +265,7 @@ export default class MainAbility extends Ability {
};
};
```
```
```
t
ypescript
```
t
s
// pages/index.ets
// pages/index.ets
import
context
from
'
@ohos.application.context
'
import
context
from
'
@ohos.application.context
'
...
@@ -290,7 +291,6 @@ struct Index {
...
@@ -290,7 +291,6 @@ struct Index {
.
height
(
'
100%
'
)
.
height
(
'
100%
'
)
}
}
}
}
```
```
## 常见错误使用方式
## 常见错误使用方式
...
...
zh-cn/application-dev/reference/apis/js-apis-Context.md
浏览文件 @
d17967aa
...
@@ -30,7 +30,7 @@ getOrCreateLocalDir(callback: AsyncCallback\<string>): void
...
@@ -30,7 +30,7 @@ getOrCreateLocalDir(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | -------------
-------------
|
| -------- | ---------------------- | ---- | ------------- |
| callback | AsyncCallback
\<
string> | 是 | 返回应用程序的本地根目录。 |
| callback | AsyncCallback
\<
string> | 是 | 返回应用程序的本地根目录。 |
**示例:**
**示例:**
...
@@ -58,7 +58,7 @@ getOrCreateLocalDir(): Promise\<string>
...
@@ -58,7 +58,7 @@ getOrCreateLocalDir(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------- | -----------
-----------
|
| ---------------- | ----------- |
| Promise
\<
string> | 应用程序的本地根目录。 |
| Promise
\<
string> | 应用程序的本地根目录。 |
**示例:**
**示例:**
...
@@ -84,7 +84,7 @@ verifyPermission(permission: string, options: PermissionOptions, callback: Async
...
@@ -84,7 +84,7 @@ verifyPermission(permission: string, options: PermissionOptions, callback: Async
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| ---------- | --------------------------------------- | ---- | --------------------
-----------------
|
| ---------- | --------------------------------------- | ---- | -------------------- |
| permission | string | 是 | 指定权限的名称。 |
| permission | string | 是 | 指定权限的名称。 |
| options |
[
PermissionOptions
](
#permissionoptions
)
| 是 | 权限选项。 |
| options |
[
PermissionOptions
](
#permissionoptions
)
| 是 | 权限选项。 |
| callback | AsyncCallback
\<
number> | 是 | 返回权限验证结果,0有权限,-1无权限。 |
| callback | AsyncCallback
\<
number> | 是 | 返回权限验证结果,0有权限,-1无权限。 |
...
@@ -113,7 +113,7 @@ verifyPermission(permission: string, callback: AsyncCallback\<number>): void
...
@@ -113,7 +113,7 @@ verifyPermission(permission: string, callback: AsyncCallback\<number>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ---------------------- | ---- | --------------------
-----------------
|
| ---------- | ---------------------- | ---- | -------------------- |
| permission | string | 是 | 指定权限的名称。 |
| permission | string | 是 | 指定权限的名称。 |
| callback | AsyncCallback
\<
number> | 是 | 返回权限验证结果,0有权限,-1无权限。 |
| callback | AsyncCallback
\<
number> | 是 | 返回权限验证结果,0有权限,-1无权限。 |
...
@@ -136,14 +136,14 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb
...
@@ -136,14 +136,14 @@ verifyPermission(permission: string, options?: PermissionOptions): Promise\<numb
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| ---------- | --------------------------------------- | ---- | --------
--------
|
| ---------- | --------------------------------------- | ---- | -------- |
| permission | string | 是 | 指定权限的名称。 |
| permission | string | 是 | 指定权限的名称。 |
| options |
[
PermissionOptions
](
#permissionoptions
)
| 否 | 权限选项。 |
| options |
[
PermissionOptions
](
#permissionoptions
)
| 否 | 权限选项。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------- | ----------------------------------
-------------------------
|
| ---------------- | ---------------------------------- |
| Promise
\<
number> | 如果pid和uid具有权限,则使用0进行异步回调;否则使用-1回调。 |
| Promise
\<
number> | 如果pid和uid具有权限,则使用0进行异步回调;否则使用-1回调。 |
**示例:**
**示例:**
...
@@ -171,7 +171,7 @@ requestPermissionsFromUser(permissions: Array\<string>, requestCode: number, res
...
@@ -171,7 +171,7 @@ requestPermissionsFromUser(permissions: Array\<string>, requestCode: number, res
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ----------------------------------------
-------------------- | ---- | ------------
----------------------------------- |
| -------------- | ----------------------------------------
| ---- |
----------------------------------- |
| permissions | Array
\<
string> | 是 | 指示要请求的权限列表。此参数不能为null。 |
| permissions | Array
\<
string> | 是 | 指示要请求的权限列表。此参数不能为null。 |
| requestCode | number | 是 | 指示要传递给PermissionRequestResult的请求代码。 |
| requestCode | number | 是 | 指示要传递给PermissionRequestResult的请求代码。 |
| resultCallback | AsyncCallback
<
[
PermissionRequestResult
](
#permissionrequestresult
)
>
| 是 | 返回授权结果信息。 |
| resultCallback | AsyncCallback
<
[
PermissionRequestResult
](
#permissionrequestresult
)
>
| 是 | 返回授权结果信息。 |
...
@@ -207,7 +207,7 @@ getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>): void
...
@@ -207,7 +207,7 @@ getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ------------------------------- | ---- | ------------
------------
|
| -------- | ------------------------------- | ---- | ------------ |
| callback | AsyncCallback
\<
ApplicationInfo> | 是 | 返回当前应用程序的信息。 |
| callback | AsyncCallback
\<
ApplicationInfo> | 是 | 返回当前应用程序的信息。 |
**示例:**
**示例:**
...
@@ -231,7 +231,7 @@ getApplicationInfo(): Promise\<ApplicationInfo>
...
@@ -231,7 +231,7 @@ getApplicationInfo(): Promise\<ApplicationInfo>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------------- | ---------
---------
|
| ------------------------- | --------- |
| Promise
\<
ApplicationInfo> | 当前应用程序的信息 |
| Promise
\<
ApplicationInfo> | 当前应用程序的信息 |
**示例:**
**示例:**
...
@@ -258,7 +258,7 @@ getBundleName(callback: AsyncCallback\<string>): void
...
@@ -258,7 +258,7 @@ getBundleName(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ------------------
-----------
|
| -------- | ---------------------- | ---- | ------------------ |
| callback | AsyncCallback
\<
string> | 是 | 返回当前ability的捆绑包名称。 |
| callback | AsyncCallback
\<
string> | 是 | 返回当前ability的捆绑包名称。 |
**示例:**
**示例:**
...
@@ -282,7 +282,7 @@ getBundleName(): Promise\<string>
...
@@ -282,7 +282,7 @@ getBundleName(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------- | ----------------
---------
|
| ---------------- | ---------------- |
| Promise
\<
string> | 当前ability的捆绑包名称。 |
| Promise
\<
string> | 当前ability的捆绑包名称。 |
**示例:**
**示例:**
...
@@ -307,7 +307,7 @@ getDisplayOrientation(callback: AsyncCallback\<bundle.DisplayOrientation>): void
...
@@ -307,7 +307,7 @@ getDisplayOrientation(callback: AsyncCallback\<bundle.DisplayOrientation>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------
| ---- | --------------------
--------- |
| -------- | ----------------------
------------------ | ---- |
--------- |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
**示例:**
**示例:**
...
@@ -329,7 +329,7 @@ getDisplayOrientation(): Promise\<bundle.DisplayOrientation>;
...
@@ -329,7 +329,7 @@ getDisplayOrientation(): Promise\<bundle.DisplayOrientation>;
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ----------------
| ----------------
--------- |
| ----------------
------------------------ |
--------- |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 表示屏幕显示方向。 |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 表示屏幕显示方向。 |
**示例:**
**示例:**
...
@@ -354,7 +354,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCal
...
@@ -354,7 +354,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCal
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| --------
| ---------------------- | ---- | -----------------
------------ |
| --------
--- | ---------------------------------------- | ---- |
------------ |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
| 是 | 指示当前能力的新方向。。 |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
| 是 | 指示当前能力的新方向。。 |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
...
@@ -381,8 +381,8 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation): Promise\<void>;
...
@@ -381,8 +381,8 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation): Promise\<void>;
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ----------------
|
------------------------- |
| ----------------
------------------------ | ---------------
------------------------- |
| orientation
|
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
| 是 | 指示当前能力的新方向。。
|
| orientation
|
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
|
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 表示屏幕显示方向。 |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 表示屏幕显示方向。 |
**示例:**
**示例:**
...
@@ -409,7 +409,7 @@ setShowOnLockScreen(show: boolean, callback: AsyncCallback\<void>): void
...
@@ -409,7 +409,7 @@ setShowOnLockScreen(show: boolean, callback: AsyncCallback\<void>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------
-- | ---- |
----------------------------- |
| -------- | --------------------
| ---- | -----------
----------------------------- |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示,值false表示不显示。 |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示,值false表示不显示。 |
| callback | AsyncCallback
\<
void> | 是 | 返回回调结果。 |
| callback | AsyncCallback
\<
void> | 是 | 返回回调结果。 |
...
@@ -435,14 +435,14 @@ setShowOnLockScreen(show: boolean): Promise\<void>;
...
@@ -435,14 +435,14 @@ setShowOnLockScreen(show: boolean): Promise\<void>;
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| ----
---- | ---------------------- | ---- |
----------------------------- |
| ----
| ------- | ---- | -----------
----------------------------- |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示,值false表示不显示。 |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示,值false表示不显示。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------------
-- | ----------
--------------- |
| --------------
|
--------------- |
|
Promise
\<
void>
| 使用Promise形式返回结果 |
|
Promise
\<
void>
| 使用Promise形式返回结果 |
**示例:**
**示例:**
...
@@ -467,7 +467,7 @@ setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback\<void>): void
...
@@ -467,7 +467,7 @@ setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback\<void>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------
-- | ---- |
----------------------------- |
| -------- | --------------------
| ---- | ----
----------------------------- |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它,值false表示不唤醒它。 |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它,值false表示不唤醒它。 |
| callback | AsyncCallback
\<
void> | 是 | 返回回调结果。 |
| callback | AsyncCallback
\<
void> | 是 | 返回回调结果。 |
...
@@ -493,14 +493,14 @@ setWakeUpScreen(wakeUp: boolean): Promise\<void>;
...
@@ -493,14 +493,14 @@ setWakeUpScreen(wakeUp: boolean): Promise\<void>;
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| ------
-- | ---------------------- | ---- |
----------------------------- |
| ------
| ------- | ---- | ----
----------------------------- |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它,值false表示不唤醒它。 |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它,值false表示不唤醒它。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------------
-- | ----------
--------------- |
| --------------
|
--------------- |
|
Promise
\<
void>
| 使用Promise形式返回结果 |
|
Promise
\<
void>
| 使用Promise形式返回结果 |
**示例:**
**示例:**
...
@@ -528,7 +528,7 @@ getProcessInfo(callback: AsyncCallback\<ProcessInfo>): void
...
@@ -528,7 +528,7 @@ getProcessInfo(callback: AsyncCallback\<ProcessInfo>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------------- | ---- | ----------
----------
|
| -------- | --------------------------- | ---- | ---------- |
| callback | AsyncCallback
\<
ProcessInfo> | 是 | 返回当前进程的信息。 |
| callback | AsyncCallback
\<
ProcessInfo> | 是 | 返回当前进程的信息。 |
**示例:**
**示例:**
...
@@ -552,7 +552,7 @@ getProcessInfo(): Promise\<ProcessInfo>
...
@@ -552,7 +552,7 @@ getProcessInfo(): Promise\<ProcessInfo>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------------------- | -------
-------
|
| --------------------- | ------- |
| Promise
\<
ProcessInfo> | 当前进程的信息 |
| Promise
\<
ProcessInfo> | 当前进程的信息 |
**示例:**
**示例:**
...
@@ -581,7 +581,7 @@ getElementName(callback: AsyncCallback\<ElementName>): void
...
@@ -581,7 +581,7 @@ getElementName(callback: AsyncCallback\<ElementName>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------------- | ---- | --------------------------------------
--------
|
| -------- | --------------------------- | ---- | -------------------------------------- |
| callback | AsyncCallback
\<
ElementName> | 是 | 返回当前ability的ohos.bundle.ElementName对象。 |
| callback | AsyncCallback
\<
ElementName> | 是 | 返回当前ability的ohos.bundle.ElementName对象。 |
**示例:**
**示例:**
...
@@ -607,7 +607,7 @@ getElementName(): Promise\<ElementName>
...
@@ -607,7 +607,7 @@ getElementName(): Promise\<ElementName>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------------------- | ------------------------------------
------
|
| --------------------- | ------------------------------------ |
| Promise
\<
ElementName> | 当前ability的ohos.bundle.ElementName对象。 |
| Promise
\<
ElementName> | 当前ability的ohos.bundle.ElementName对象。 |
**示例:**
**示例:**
...
@@ -632,7 +632,7 @@ getProcessName(callback: AsyncCallback\<string>): void
...
@@ -632,7 +632,7 @@ getProcessName(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------
----------
|
| -------- | ---------------------- | ---- | ---------- |
| callback | AsyncCallback
\<
string> | 是 | 返回当前进程的名称。 |
| callback | AsyncCallback
\<
string> | 是 | 返回当前进程的名称。 |
**示例:**
**示例:**
...
@@ -656,7 +656,7 @@ getProcessName(): Promise\<string>
...
@@ -656,7 +656,7 @@ getProcessName(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------- | ----------
----------
|
| ---------------- | ---------- |
| Promise
\<
string> | 返回当前进程的名称。 |
| Promise
\<
string> | 返回当前进程的名称。 |
**示例:**
**示例:**
...
@@ -683,7 +683,7 @@ getCallingBundle(callback: AsyncCallback\<string>): void
...
@@ -683,7 +683,7 @@ getCallingBundle(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------
---------
|
| -------- | ---------------------- | ---- | ---------------- |
| callback | AsyncCallback
\<
string> | 是 | 返回调用ability的包名称。 |
| callback | AsyncCallback
\<
string> | 是 | 返回调用ability的包名称。 |
**示例:**
**示例:**
...
@@ -707,7 +707,7 @@ getCallingBundle(): Promise\<string>
...
@@ -707,7 +707,7 @@ getCallingBundle(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| -----------
-------------- |
| ---------------
- |
-------------- |
| Promise
\<
string> | 调用ability的包名称。 |
| Promise
\<
string> | 调用ability的包名称。 |
**示例:**
**示例:**
...
@@ -732,8 +732,8 @@ getCacheDir(callback: AsyncCallback\<string>): void
...
@@ -732,8 +732,8 @@ getCacheDir(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ---------------
----------
|
| -------- | ---------------------- | ---- | --------------- |
| callback | AsyncCallback
\<
string> | 是
| 返回该应用程序的内部存储目录。
|
| callback | AsyncCallback
\<
string> | 是
| 返回该应用程序的内部存储目录。
|
**示例:**
**示例:**
...
@@ -760,7 +760,7 @@ getCacheDir(): Promise\<string>
...
@@ -760,7 +760,7 @@ getCacheDir(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| ----------
--------------- |
| ---------------
- |
--------------- |
| Promise
\<
string> | 获取该应用程序的内部存储目录。 |
| Promise
\<
string> | 获取该应用程序的内部存储目录。 |
**示例:**
**示例:**
...
@@ -785,8 +785,8 @@ getFilesDir(callback: AsyncCallback\<string>): void
...
@@ -785,8 +785,8 @@ getFilesDir(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | -------------------
------
|
| -------- | ---------------------- | ---- | ------------------- |
| callback | AsyncCallback
\<
string> | 是
| 返回内部存储器上此应用程序的文件目录。
|
| callback | AsyncCallback
\<
string> | 是
| 返回内部存储器上此应用程序的文件目录。
|
**示例:**
**示例:**
...
@@ -813,7 +813,7 @@ getFilesDir(): Promise\<string>
...
@@ -813,7 +813,7 @@ getFilesDir(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| ------
------------------- |
| ---------------
- |
------------------- |
| Promise
\<
string> | 返回内部存储器上此应用程序的文件目录。 |
| Promise
\<
string> | 返回内部存储器上此应用程序的文件目录。 |
**示例:**
**示例:**
...
@@ -840,8 +840,8 @@ getOrCreateDistributedDir(callback: AsyncCallback\<string>): void
...
@@ -840,8 +840,8 @@ getOrCreateDistributedDir(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ------------------------- |
| -------- | ---------------------- | ---- | -------------------------
---------------
|
| callback | AsyncCallback
\<
string> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回Ability或应用的分布式文件路径。如果分布式文件路径不存在,系统将创建一个路径并返回创建的路径。
|
| callback | AsyncCallback
\<
string> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回Ability或应用的分布式文件路径。如果分布式文件路径不存在,系统将创建一个路径并返回创建的路径。
|
**示例:**
**示例:**
...
@@ -870,7 +870,7 @@ getOrCreateDistributedDir(): Promise\<string>
...
@@ -870,7 +870,7 @@ getOrCreateDistributedDir(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
|
------------------------- |
| ---------------
- | ----------
------------------------- |
| Promise
\<
string> | Ability或应用的分布式文件路径。如果是第一次调用,则将创建目录。 |
| Promise
\<
string> | Ability或应用的分布式文件路径。如果是第一次调用,则将创建目录。 |
**示例:**
**示例:**
...
@@ -894,8 +894,8 @@ getAppType(callback: AsyncCallback\<string>): void
...
@@ -894,8 +894,8 @@ getAppType(callback: AsyncCallback\<string>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ------------------------- |
| -------- | ---------------------- | ---- | -------------------------
-------
|
| callback | AsyncCallback
\<
string> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回此应用程序的类型。
|
| callback | AsyncCallback
\<
string> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回此应用程序的类型。
|
**示例:**
**示例:**
...
@@ -922,7 +922,7 @@ getAppType(): Promise\<string>
...
@@ -922,7 +922,7 @@ getAppType(): Promise\<string>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| -------
------------------ |
| ---------------
- |
------------------ |
| Promise
\<
string> | Promise形式返回此应用的类型。 |
| Promise
\<
string> | Promise形式返回此应用的类型。 |
**示例:**
**示例:**
...
@@ -946,8 +946,8 @@ getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void
...
@@ -946,8 +946,8 @@ getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------
| ---- |
------------------------- |
| -------- | ----------------------
------------------ | ---- | --------------
------------------------- |
| callback | AsyncCallback
\<
[
HapModuleInfo
](
js-apis-bundle-HapModuleInfo.md
)
> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回应用的ModuleInfo对象。
|
| callback | AsyncCallback
\<
[
HapModuleInfo
](
js-apis-bundle-HapModuleInfo.md
)
> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回应用的ModuleInfo对象。
|
**示例:**
**示例:**
...
@@ -974,7 +974,7 @@ getHapModuleInfo(): Promise\<HapModuleInfo>
...
@@ -974,7 +974,7 @@ getHapModuleInfo(): Promise\<HapModuleInfo>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| -------
------------------ |
| ---------------
------------------------- |
------------------ |
| Promise
\<
[
HapModuleInfo
](
js-apis-bundle-HapModuleInfo.md
)
> | 返回应用的ModuleInfo对象。 |
| Promise
\<
[
HapModuleInfo
](
js-apis-bundle-HapModuleInfo.md
)
> | 返回应用的ModuleInfo对象。 |
**示例:**
**示例:**
...
@@ -998,8 +998,8 @@ getAppVersionInfo(callback: AsyncCallback\<AppVersionInfo>): void
...
@@ -998,8 +998,8 @@ getAppVersionInfo(callback: AsyncCallback\<AppVersionInfo>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------
| ---- |
------------------------- |
| -------- | ----------------------
------------------ | ---- | -----
------------------------- |
| callback | AsyncCallback
\<
[
AppVersionInfo
](
#appversioninfo
)
> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回应用版本信息。
|
| callback | AsyncCallback
\<
[
AppVersionInfo
](
#appversioninfo
)
> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回应用版本信息。
|
**示例:**
**示例:**
...
@@ -1026,7 +1026,7 @@ getAppVersionInfo(): Promise\<AppVersionInfo>
...
@@ -1026,7 +1026,7 @@ getAppVersionInfo(): Promise\<AppVersionInfo>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| ----------------
--------- |
| ---------------
------------------------- |
--------- |
| Promise
\<
[
AppVersionInfo
](
#appversioninfo
)
> | 返回应用版本信息。 |
| Promise
\<
[
AppVersionInfo
](
#appversioninfo
)
> | 返回应用版本信息。 |
**示例:**
**示例:**
...
@@ -1050,8 +1050,8 @@ getAbilityInfo(callback: AsyncCallback\<AbilityInfo>): void
...
@@ -1050,8 +1050,8 @@ getAbilityInfo(callback: AsyncCallback\<AbilityInfo>): void
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------
| ---- |
------------------------- |
| -------- | ----------------------
------------------ | ---- | --------------
------------------------- |
| callback | AsyncCallback
\<
[
AbilityInfo
](
js-apis-bundle-AbilityInfo.md
)
> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回当前归属Ability详细信息。
|
| callback | AsyncCallback
\<
[
AbilityInfo
](
js-apis-bundle-AbilityInfo.md
)
> | 是
| 回调函数,可以在回调函数中处理接口返回值,返回当前归属Ability详细信息。
|
**示例:**
**示例:**
...
@@ -1078,7 +1078,7 @@ getAbilityInfo(): Promise\<AbilityInfo>
...
@@ -1078,7 +1078,7 @@ getAbilityInfo(): Promise\<AbilityInfo>
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
| -------
------------------ |
| ---------------
------------------------- |
------------------ |
| Promise
\<
[
AbilityInfo
](
js-apis-bundle-AbilityInfo.md
)
> | 返回当前归属Ability详细信息。 |
| Promise
\<
[
AbilityInfo
](
js-apis-bundle-AbilityInfo.md
)
> | 返回当前归属Ability详细信息。 |
**示例:**
**示例:**
...
@@ -1102,7 +1102,7 @@ getApplicationContext(): Context
...
@@ -1102,7 +1102,7 @@ getApplicationContext(): Context
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------
-- |
------ |
| -------
| ----
------ |
| Context | 返回应用上下文信息。 |
| Context | 返回应用上下文信息。 |
**示例:**
**示例:**
...
@@ -1123,8 +1123,8 @@ isUpdatingConfigurations(callback: AsyncCallback\<boolean>): void;
...
@@ -1123,8 +1123,8 @@ isUpdatingConfigurations(callback: AsyncCallback\<boolean>): void;
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------
| ---- |
------------------------- |
| -------- | ----------------------
- | ---- | ----
------------------------- |
| callback | AsyncCallback
\<
boolean> | 是
| 如果该能力的配置正在更改,则为true,否则为false。
|
| callback | AsyncCallback
\<
boolean> | 是
| 如果该能力的配置正在更改,则为true,否则为false。
|
**示例:**
**示例:**
...
@@ -1151,8 +1151,8 @@ isUpdatingConfigurations(): Promise\<boolean>;
...
@@ -1151,8 +1151,8 @@ isUpdatingConfigurations(): Promise\<boolean>;
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------
|
------------------------- |
| ---------------
-- | ----
------------------------- |
|Promise
\<
boolean> | 如果该能力的配置正在更改,则为true,否则为false。 |
|
Promise
\<
boolean> | 如果该能力的配置正在更改,则为true,否则为false。 |
**示例:**
**示例:**
...
@@ -1175,8 +1175,8 @@ printDrawnCompleted(callback: AsyncCallback\<void>): void;
...
@@ -1175,8 +1175,8 @@ printDrawnCompleted(callback: AsyncCallback\<void>): void;
**参数:**
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------
-- | ---- | --------------
----------- |
| -------- | --------------------
| ---- |
----------- |
| callback | AsyncCallback
\<
void> | 是
| 表示被指定的回调方法。
|
| callback | AsyncCallback
\<
void> | 是
| 表示被指定的回调方法。
|
**示例:**
**示例:**
...
@@ -1203,8 +1203,8 @@ printDrawnCompleted(): Promise\<void>;
...
@@ -1203,8 +1203,8 @@ printDrawnCompleted(): Promise\<void>;
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| --------------
- | ----------
--------------- |
| --------------
|
--------------- |
|Promise
\<
void> | 以Promise形式返回结果。 |
|
Promise
\<
void> | 以Promise形式返回结果。 |
**示例:**
**示例:**
...
@@ -1222,7 +1222,7 @@ context.printDrawnCompleted().then((data) => {
...
@@ -1222,7 +1222,7 @@ context.printDrawnCompleted().then((data) => {
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | ----
---- | ------ | ---- | -
----- |
| ---- | ----
| ------ | ---- |
----- |
| pid | 只读 | number | 否 | 进程id。 |
| pid | 只读 | number | 否 | 进程id。 |
| uid | 只读 | number | 否 | 用户id。 |
| uid | 只读 | number | 否 | 用户id。 |
...
@@ -1231,7 +1231,7 @@ context.printDrawnCompleted().then((data) => {
...
@@ -1231,7 +1231,7 @@ context.printDrawnCompleted().then((data) => {
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | ----
---- | -------------- | ---- | --------
---------- |
| ----------- | ----
| -------------- | ---- |
---------- |
| requestCode | 只读 | number | 是 | 用户传入的请求代码。 |
| requestCode | 只读 | number | 是 | 用户传入的请求代码。 |
| permissions | 只读 | Array
\<
string> | 是 | 用户传入的权限。 |
| permissions | 只读 | Array
\<
string> | 是 | 用户传入的权限。 |
| authResults | 只读 | Array
\<
number> | 是 | 请求权限的结果。 |
| authResults | 只读 | Array
\<
number> | 是 | 请求权限的结果。 |
...
@@ -1241,7 +1241,7 @@ context.printDrawnCompleted().then((data) => {
...
@@ -1241,7 +1241,7 @@ context.printDrawnCompleted().then((data) => {
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------
| ------ | ------| ------ | ------
|
| ------
----- | ------ | ---- | ---- | -------
|
| appName | string | 是 | 否 | 模块名称。 |
| appName | string | 是 | 否 | 模块名称。 |
| versionCode | number | 是 | 否 | 模块描述信息。 |
| versionCode | number | 是 | 否 | 模块描述信息。 |
| versionName | string | 是 | 否 | 描述信息ID。 |
| versionName | string | 是 | 否 | 描述信息ID。 |
zh-cn/application-dev/ui/ts-event-configuration.md
浏览文件 @
d17967aa
# 事件配置
# 事件配置
通过事件方法可以配置组件支持的事件。
通过事件方法可以配置组件支持的事件。
从API Version 9开始,可以在回调函数中获取当前component关联的Context,具体用法请参考
[
在eTS页面中访问Context
](
../ability/context-userguide.md
)
。
-
使用lambda表达式配置组件的事件方法:
-
使用lambda表达式配置组件的事件方法:
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录