Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 84ce10c6 编写于 作者: L liminjie10 提交者： Gitee
浏览文件
操作

update zh-cn/application-dev/reference/apis/js-apis-settings.md. 

Signed-off-by: Nliminjie10 <liminjie10@huawei.com>
上级 f38da453
显示空白变更内容
内联 并排
Showing with 42 addition and 18 deletion
zh-cn/application-dev/reference/apis/js-apis-settings.md
浏览文件 @ 84ce10c6
......@@ -372,10 +372,12 @@ let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
getValue(context: Context, name: string, callback: AsyncCallback\<string>): void
stage模型使用。获取数据库中指定数据项的值。使用callback异步回调。
获取数据库中指定数据项的值。使用callback异步回调。
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在Stage模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -400,10 +402,12 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, (err,
getValue(context: Context, name: string): Promise\<string>
stage模型使用。获取数据库中指定数据项的值。使用Promise异步回调。
获取数据库中指定数据项的值。使用Promise异步回调。
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在Stage模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -430,10 +434,12 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS)
getValueSync(context: Context, name: string, defValue: string): string
stage模型使用。获取数据项的值。此方法相较getValue为同步方法。
获取数据项的值。此方法相较getValue为同步方法。
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在Stage模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -459,12 +465,14 @@ let value = settings.getValueSync(this.context, settings.display.SCREEN_BRIGHTNE
setValue(context: Context, name: string, value: string, callback: AsyncCallback\<boolean>): void
stage模型使用。将数据项名称及数据项的值保存到数据库中。使用callback异步回调。
将数据项名称及数据项的值保存到数据库中。使用callback异步回调。
**需要权限**：ohos.permission.MANAGE_SECURE_SETTINGS，仅系统应用可用。
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在Stage模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -486,12 +494,14 @@ settings.setValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100'
setValue(context: Context, name: string, value: string): Promise\<boolean>
stage模型使用。将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。
将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。
**需要权限**：ohos.permission.MANAGE_SECURE_SETTINGS，仅系统应用可用。
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在Stage模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -518,7 +528,7 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then
setValueSync(context: Context, name: string, value: string): boolean
stage模型使用。设置数据项的值。此方法相较setValue为同步方法。
设置数据项的值。此方法相较setValue为同步方法。
如果数据库中已经存在该数据项，则setValueSync方法将更新该数据项的值；如果数据库中尚未存在该数据项，则setValueSync方法将向数据库中插入该数据项。
......@@ -526,6 +536,8 @@ stage模型使用。设置数据项的值。此方法相较setValue为同步方
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在Stage模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -547,9 +559,9 @@ stage模型使用。设置数据项的值。此方法相较setValue为同步方
let ret = settings.setValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100');
```
## setting.getValue<sup>deprecated</sup>
## setting.getValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护，建议使用stage模型的对应接口。
> 从API version 7开始支持，从API version 9开始废弃，推荐使用[getValue()](#settinggetvalue9)。
getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\<string>): void
......@@ -557,6 +569,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在FA模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -581,9 +595,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value
});
```
## setting.getValue<sup>deprecated</sup>
## setting.getValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护，建议使用stage模型的对应接口。
> 从API version 7开始支持，从API version 9开始废弃，推荐使用[getValue()](#settinggetvalue9-1)。
getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<string>
......@@ -591,6 +605,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<string>
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在FA模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -616,9 +632,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value
});
```
## settings.setValue<sup>deprecated</sup>
## settings.setValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护，建议使用stage模型的对应接口。
> 从API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](#settingssetvalue9)。
setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, callback: AsyncCallback\<boolean>): void
......@@ -628,6 +644,8 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, call
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在FA模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -650,9 +668,9 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (res
});
```
## settings.setValue<sup>deprecated</sup>
## settings.setValue<sup>(deprecated)</sup>
> 从API version 9开始不再维护，建议使用stage模型的对应接口。
> 从API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](#settingssetvalue9-1)。
setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Promise\<boolean>
......@@ -662,6 +680,8 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Pro
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在FA模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -689,9 +709,9 @@ settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then
});
```
## settings.getValueSync<sup>8+</sup> <sup>deprecated</sup>
## settings.getValueSync<sup>(deprecated)</sup>
> 从API version 9开始不再维护，建议使用stage模型的对应接口。
> 从API version 8开始支持，从API version 9开始废弃，推荐使用[getValueSync()](#settingsgetvaluesync9)。
getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string
......@@ -699,6 +719,8 @@ getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: strin
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在FA模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -724,9 +746,9 @@ let helper = featureAbility.acquireDataAbilityHelper(uri);
let value = settings.getValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '10');
```
## settings.setValueSync<sup>8+</sup> <sup>deprecated</sup>
## settings.setValueSync<sup>(deprecated)</sup>
> 从API version 9开始不再维护，建议使用stage模型的对应接口。
> 从API version 8开始支持，从API version 9开始废弃，推荐使用[setValueSync()](#settingssetvaluesync9)。
setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean
......@@ -738,6 +760,8 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string):
**系统能力**：SystemCapability.Applications.settings.Core
**模型约束**：此接口仅可在FA模型下使用。
**参数**：
| 参数名 | 类型 | 必填 | 说明 |
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或