diff --git a/zh-cn/application-dev/application-models/Readme-CN.md b/zh-cn/application-dev/application-models/Readme-CN.md index c2832d868702c9a10eef9ad2fb46377028bf34bb..1b049c61533bdab60c8a4bae444666c7f4f8227d 100644 --- a/zh-cn/application-dev/application-models/Readme-CN.md +++ b/zh-cn/application-dev/application-models/Readme-CN.md @@ -51,6 +51,7 @@ - [任务管理场景介绍](mission-management-overview.md) - [任务管理与启动模式](mission-management-launch-type.md) - [页面栈及任务链](page-mission-stack.md) + - [设置任务快照的图标和名称](mission-set-icon-name-for-task-snapshot) - [Stage模型应用配置文件](config-file-stage.md) - FA模型开发指导 - [FA模型开发概述](fa-model-development-overview.md) diff --git a/zh-cn/application-dev/application-models/figures/mission-list-recent.png b/zh-cn/application-dev/application-models/figures/mission-list-recent.png new file mode 100644 index 0000000000000000000000000000000000000000..89e767820a16ae44efa3394065b4091549b2cd63 Binary files /dev/null and b/zh-cn/application-dev/application-models/figures/mission-list-recent.png differ diff --git a/zh-cn/application-dev/application-models/figures/mission-set-task-snapshot-icon.png b/zh-cn/application-dev/application-models/figures/mission-set-task-snapshot-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..0139f2c56d891e173361499ae60dc9c644e6d5bb Binary files /dev/null and b/zh-cn/application-dev/application-models/figures/mission-set-task-snapshot-icon.png differ diff --git a/zh-cn/application-dev/application-models/figures/mission-set-task-snapshot-label.png b/zh-cn/application-dev/application-models/figures/mission-set-task-snapshot-label.png new file mode 100644 index 0000000000000000000000000000000000000000..bca666ccec2c522f7166f3ce8e27076dde0c0b68 Binary files /dev/null and b/zh-cn/application-dev/application-models/figures/mission-set-task-snapshot-label.png differ diff --git a/zh-cn/application-dev/application-models/mission-set-icon-name-for-task-snapshot.md b/zh-cn/application-dev/application-models/mission-set-icon-name-for-task-snapshot.md new file mode 100644 index 0000000000000000000000000000000000000000..879ee333eb0dae97efcaf7653139b7d46f35a7d3 --- /dev/null +++ b/zh-cn/application-dev/application-models/mission-set-icon-name-for-task-snapshot.md @@ -0,0 +1,46 @@ +# 设置任务快照的图标和名称 + +设置任务快照的图标和名称是为了提高用户界面的可视化性和用户体验,以便更好地管理和跟踪应用程序中的任务和功能。通过为每个任务快照设置不同的图标和名称,可以更轻松地区分和识别每个任务和功能。 + +默认情况下任务快照的图标和名称采用的是[module.json5配置文件](../quick-start/module-configuration-file.md)的[abilities标签](../quick-start/module-configuration-file.md#abilities标签)中的icon和label字段,如下图所示。 + +图1 UIAbility对应的任务快照 +mission-list-recent + +也可以使用[UIAbilityContext.setMissionIcon()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextsetmissionicon)和[UIAbilityContext.setMissionLabel()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextsetmissionlabel)方法,根据需要自定义任务快照的图标和名称。例如,对于UIAbility的标准实例启动模式,可以根据不同的功能配置相应的任务快照的图标和名称。 + +本文将从以下两个方面介绍。 + +- [设置任务快照的图标(仅对系统应用开放)](#设置任务快照的图标(仅对系统应用开放)) +- [设置任务快照的名称](#设置任务快照的名称) + +## 设置任务快照的图标(仅对系统应用开放) + +通过调用[UIAbilityContext.setMissionIcon()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextsetmissionicon)方法修改任务快照的图标。图片内容为[PixelMap](../reference/apis/js-apis-image.md#pixelmap7)类型对象。示例中的context的获取方式请参见[获取UIAbility的上下文信息](uiability-usage.md#获取uiability的上下文信息)。 +```ts +let imagePixelMap: PixelMap = undefined; // 需要获取图片PixelMap信息 + +this.context.setMissionIcon(imagePixelMap, (err) => { + console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); +}) +``` + +效果示意如下图所示。 + +图2 置任务快照的图标 +mission-set-task-snapshot-icon + +## 设置任务快照的名称 + +通过调用[UIAbilityContext.setMissionLabel()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextsetmissionlabel)方法修改任务快照的名称。 + +```ts +this.context.setMissionLabel('test').then(() => { + console.log('setMissionLabel succeeded.'); +}).catch((err) => { + console.log(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`); +}); +``` + +效果示意如下图所示。 +mission-set-task-snapshot-label \ No newline at end of file