鸿蒙API14开辟【@ohos.uiAppearance (用户界面外观)(系统接口)】应用框架AP ...

用户界面外观提供管理系统外观的一些基础能力，现在仅包括深淡色模式设置。
   分析：
  从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
  本模块接口为系统接口。
  导入模块

1. import { uiAppearance } from '@kit.ArkUI'
2. ts

复制代码

DarkMode

深色模式枚举。
系统能力：  SystemCapability.ArkUI.UiAppearance
名称值分析ALWAYS_DARK0系统始终为深色。ALWAYS_LIGHT1系统始终为淡色。 uiAppearance.setDarkMode

setDarkMode(mode: DarkMode, callback: AsyncCallback): void
设置系统深色模式。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
参数：
参数名类型必填分析mode[DarkMode]是指定系统的深色模式设置callbackAsyncCallback 错误码ID错误信息201Permission denied.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
3. try {
4.   uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK, (error) => {
5.     if (error) {
6.       console.error('Set dark-mode failed, ' + error.message);
7.     } else {
8.       console.info('Set dark-mode successfully.');
9.     }
10.   })
11. } catch (error) {
12.   let message = (error as BusinessError).message;
13.   console.error('Set dark-mode failed, ' + message);
14. }
15. ts

复制代码

uiAppearance.setDarkMode

setDarkMode(mode: DarkMode): Promise;
设置系统深色模式。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
参数：
参数名类型必填分析mode[DarkMode]是指定系统深色模式设置 返回值：
类型分析PromisePromise对象。无返回结果的Promise对象。 错误码ID错误信息201Permission denied.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
3. try {
4.   uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK).then(() => {
5.     console.info('Set dark-mode successfully.');
6.   }).catch((error:Error) => {
7.     console.error('Set dark-mode failed, ' + error.message);
8.   });
9. } catch (error) {
10.   let message = (error as BusinessError).message;
11.   console.error('Set dark-mode failed, ' + message);
12. }
13. ts

复制代码

uiAppearance.getDarkMode

getDarkMode(): DarkMode;
获取当前的深色模式设置。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
返回值：
类型分析[DarkMode]系统当前的深色模式设置 错误码ID错误信息201Permission denied.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
3. try {
4.   let darkMode = uiAppearance.getDarkMode();
5.   console.info('Get dark-mode ' + darkMode);
6. } catch (error) {
7.   let message = (error as BusinessError).message;
8.   console.error('Get dark-mode failed, ' + message);
9. }
10. ts

复制代码

uiAppearance.setFontScale12+

setFontScale(fontScale: number): Promise
设置系统字体大小。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
系统接口：  此接口为系统接口。
参数：
参数名类型必填分析fontScalenumber是需要设置的字体大小。 返回值：
类型分析PromisePromise对象。无返回结果的Promise对象。 错误码ID错误信息201Permission denied.202Permission verification failed. A non-system application calls a system API.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
4. let fontScale = 10;
6. try {
7.   uiAppearance.setFontScale(fontScale).then(() => {
8.     console.info('Set fontScale successfully.');
9.   }).catch((error:Error) => {
10.     console.error('Set fontScale failed, ' + error.message);
11.   });
12. } catch (error) {
13.   let message = (error as BusinessError).message;
14.   console.error('Set fontScale failed, ' + message);
15. }
16. ts

复制代码

uiAppearance.getFontScale12+

getFontScale(): number
获取系统字体大小。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
系统接口：  此接口为系统接口。
返回值：
类型分析number系统字体大小。 错误码ID错误信息201Permission denied.202Permission verification failed. A non-system application calls a system API.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
3. try {
4.   let fontScale = uiAppearance.getFontScale();
5.   console.info('Get fontScale ' + fontScale);
6. } catch (error) {
7.   let message = (error as BusinessError).message;
8.   console.error('Get fontScale failed, ' + message);
9. }
10. ts

复制代码

uiAppearance.setFontWeightScale12+

setFontWeightScale(fontWeightScale: number): Promise
设置系统字体粗细。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
系统接口：  此接口为系统接口。
参数：
参数名类型必填分析fontWeightScalenumber是需要设置的字体粗细。 返回值：
类型分析PromisePromise对象。无返回结果的Promise对象。 错误码ID错误信息201Permission denied.202Permission verification failed. A non-system application calls a system API.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
4. let fontWeightScale = 1;
6. try {
7.   uiAppearance.setFontWeightScale(fontWeightScale).then(() => {
8.     console.info('Set fontWeightScale successfully.');
9.   }).catch((error:Error) => {
10.     console.error('Set fontWeightScale failed, ' + error.message);
11.   });
12. } catch (error) {
13.   let message = (error as BusinessError).message;
14.   console.error('Set fontWeightScale failed, ' + message);
15. }
16. ts

复制代码

uiAppearance.getFontWeightScale12+

getFontWeightScale(): number
获取系统字体大小。
需要权限：  ohos.permission.UPDATE_CONFIGURATION
系统能力：  SystemCapability.ArkUI.UiAppearance
系统接口：  此接口为系统接口。
返回值：
类型分析number系统字体粗细。 错误码ID错误信息201Permission denied.202Permission verification failed. A non-system application calls a system API.401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed.500001Internal error. 示例：

1. import { uiAppearance } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
3. try {
4.   let fontWeightScale = uiAppearance.getFontWeightScale();
5.   console.info('Get fontScale ' + fontWeightScale);
6. } catch (error) {
7.   let message = (error as BusinessError).message;
8.   console.error('Get fontWeightScale failed, ' + message);
9. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。