HarmonyOS 应用开发之设置任务快照的图标和名称

设置任务快照的图标和名称是为了提高用户界面的可视化性和用户体验,以便更好地管理和跟踪应用程序中的任务和功能。通过为每个任务快照设置不同的图标和名称,可以更轻松地区分和识别每个任务的功能。

默认情况下任务快照的图标和名称采用的是 module.json5配置文件 的 abilities标签 中的icon和label字段,如下图所示。

图1 UIAbility对应的任务快照

也可以使用 UIAbilityContext.setMissionIcon()UIAbilityContext.setMissionLabel() 方法,根据需要自定义任务快照的图标和名称。例如,对于UIAbility的多实例启动模式,可以根据不同的功能配置相应的任务快照的图标和名称。

本文将从以下两个方面介绍。

  • 设置任务快照的图标(仅对系统应用开放)
  • 设置任务快照的名称

设置任务快照的图标(仅对系统应用开放)

通过调用 UIAbilityContext.setMissionIcon() 方法修改任务快照的图标。

示例中的context的获取方式请参见 获取UIAbility的上下文信息 。示例中的pixelMap的获取方式请参见 图片解码 。

import common from '@ohos.app.ability.common';
import Logger from '../utils/Logger';
import { BusinessError } from '@ohos.base';

const TAG: string = 'EntryAbility';

...
let context: common.UIAbilityContext = this.context; // UIAbilityContext

... // 获取pixelMap

// 设置任务快照的图标
context.setMissionIcon(pixelMap, (err: BusinessError) => {
  if (err.code) {
    Logger.error(TAG, `Failed to set mission icon. Code is ${err.code}, message is ${err.message}`);
  } else {
    Logger.info(TAG, `Success to set mission icon.`);
  }
})

效果示意如下图所示。

图2 设置任务快照的图标

设置任务快照的名称

通过调用 UIAbilityContext.setMissionLabel() 方法修改任务快照的名称。

import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';
import Logger from '../utils/Logger';

const TAG: string = 'EntryAbility';

...
let context: common.UIAbilityContext = this.context; // UIAbilityContext
// 设置任务快照的名称
context.setMissionLabel('test').then(() => {
  Logger.info(TAG, 'Succeeded in seting mission label.');
}).catch((err: BusinessError) => {
  Logger.error(TAG, `Failed to set mission label. Code is ${err.code}, message is ${err.message}`);
});

效果示意如下图所示。

阅读全文
下载说明:
1、本站所有资源均从互联网上收集整理而来,仅供学习交流之用,因此不包含技术服务请大家谅解!
2、本站不提供任何实质性的付费和支付资源,所有需要积分下载的资源均为网站运营赞助费用或者线下劳务费用!
3、本站所有资源仅用于学习及研究使用,您必须在下载后的24小时内删除所下载资源,切勿用于商业用途,否则由此引发的法律纠纷及连带责任本站和发布者概不承担!
4、本站站内提供的所有可下载资源,本站保证未做任何负面改动(不包含修复bug和完善功能等正面优化或二次开发),但本站不保证资源的准确性、安全性和完整性,用户下载后自行斟酌,我们以交流学习为目的,并不是所有的源码都100%无错或无bug!如有链接无法下载、失效或广告,请联系客服处理!
5、本站资源除标明原创外均来自网络整理,版权归原作者或本站特约原创作者所有,如侵犯到您的合法权益,请立即告知本站,本站将及时予与删除并致以最深的歉意!
6、如果您也有好的资源或教程,您可以投稿发布,成功分享后有站币奖励和额外收入!
7、如果您喜欢该资源,请支持官方正版资源,以得到更好的正版服务!
8、请您认真阅读上述内容,注册本站用户或下载本站资源即您同意上述内容!
原文链接:https://www.shuli.cc/?p=21747,转载请注明出处。
0

评论0

显示验证码
没有账号?注册  忘记密码?