From 84ce10c65c70bd99a520843bf574473b090c337a Mon Sep 17 00:00:00 2001 From: liminjie10 Date: Thu, 8 Dec 2022 12:25:26 +0000 Subject: [PATCH] update zh-cn/application-dev/reference/apis/js-apis-settings.md. Signed-off-by: liminjie10 --- .../reference/apis/js-apis-settings.md | 60 +++++++++++++------ 1 file changed, 42 insertions(+), 18 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-settings.md b/zh-cn/application-dev/reference/apis/js-apis-settings.md index 278d327e3f..d91045fa56 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis/js-apis-settings.md @@ -372,10 +372,12 @@ let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); getValue(context: Context, name: string, callback: AsyncCallback\): 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\ -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\): 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\ -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.getValuedeprecated +## setting.getValue(deprecated) -> 从API version 9开始不再维护，建议使用stage模型的对应接口。 +> 从API version 7开始支持，从API version 9开始废弃，推荐使用[getValue()](#settinggetvalue9)。 getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\): 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.getValuedeprecated +## setting.getValue(deprecated) -> 从API version 9开始不再维护，建议使用stage模型的对应接口。 +> 从API version 7开始支持，从API version 9开始废弃，推荐使用[getValue()](#settinggetvalue9-1)。 getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ @@ -591,6 +605,8 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ **系统能力**：SystemCapability.Applications.settings.Core +**模型约束**：此接口仅可在FA模型下使用。 + **参数**： | 参数名 | 类型 | 必填 | 说明 | @@ -616,9 +632,9 @@ settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value }); ``` -## settings.setValuedeprecated +## settings.setValue(deprecated) -> 从API version 9开始不再维护，建议使用stage模型的对应接口。 +> 从API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](#settingssetvalue9)。 setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, callback: AsyncCallback\): 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.setValuedeprecated +## settings.setValue(deprecated) -> 从API version 9开始不再维护，建议使用stage模型的对应接口。 +> 从API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](#settingssetvalue9-1)。 setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Promise\ @@ -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.getValueSync8+ deprecated +## settings.getValueSync(deprecated) -> 从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.setValueSync8+ deprecated +## settings.setValueSync(deprecated) -> 从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模型下使用。 + **参数**： | 参数名 | 类型 | 必填 | 说明 | -- GitLab