鸿蒙Harmony应用开发—ArkTS声明式开发（通用属性：形状裁剪）

���于对组件进行裁剪、遮罩处理。

说明：

从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

clip

clip(value: boolean | CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute)

按指定的形状对当前组件进行裁剪。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	boolean | CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute	是	参数为相应类型的组件，按指定的形状对当前组件进行裁剪；参数为boolean类型时，设置是否按照父容器边缘轮廓进行裁剪。 默认值：false

mask

mask(value: CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute | ProgressMask)

为组件上添加指定形状的遮罩。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	ProgressMask10+ | CircleAttribute | EllipseAttribute | PathAttribute | RectAttribute	是	在当前组件上加上指定形状的遮罩。

ProgressMask10+

ProgressMask设置遮罩的进度、最大值和遮罩颜色。

constructor10+

constructor(value: number, total: number, color: ResourceColor)

构造ProgressMask对象。

参数：

参数名	参数类型	必填	参数描述
value	number	是	进度遮罩的当前值。
total	number	是	进度遮罩的最大值。
color	ResourceColor	是	进度遮罩的颜色。

updateProgress10+

updateProgress(value: number): void

更新进度遮罩的进度值。

参数：

参数名	参数类型	必填	参数描述
value	number	是	进度遮罩的当前值。

updateColor10+

updateColor(value: ResourceColor): void

更新进度遮罩的颜色。

参数：

参数名	参数类型	必填	参数描述
value	ResourceColor	是	进度遮罩的颜色。

示例

示例1

// xxx.ets@Entry@Componentstruct ClipAndMaskExample {  build() {    Column({ space: 15 }) {      Text('clip').fontSize(12).width('75%').fontColor('#DCDCDC')      Row() {        Image($r('app.media.testImg')).width('500px').height('280px')      }      .clip(true) // 如这里不设置clip为true，则Row组件的圆角不会限制其中的Image组件，Image组件的四个角会超出Row      .borderRadius(20)      // 用一个280px直径的圆对图片进行裁剪      Image($r('app.media.testImg'))        .clip(new Circle({ width: '280px', height: '280px' }))        .width('500px').height('280px')      Text('mask').fontSize(12).width('75%').fontColor('#DCDCDC')      // 给图片添加了一个500px*280px的方形遮罩      Image($r('app.media.testImg'))        .mask(new Rect({ width: '500px', height: '280px' }).fill(Color.Gray))        .width('500px').height('280px')      // 给图片添加了一个280px*280px的圆形遮罩      Image($r('app.media.testImg'))        .mask(new Circle({ width: '280px', height: '280px' }).fill(Color.Gray))        .width('500px').height('280px')    }    .width('100%')    .margin({ top: 15 })  }}

示例2

@Entry@Componentstruct ProgressMaskExample {  @State progressflag1: boolean = true;  @State color: Color = 0x01006CDE;  @State value: number = 10.0;  @State progress: ProgressMask = new ProgressMask(10.0, 100.0, Color.Gray);  build() {    Column({ space: 15 }) {      Text('progress mask').fontSize(12).width('75%').fontColor('#DCDCDC')      // 给图片添加了一个280px*280px的进度遮罩      Image($r('app.media.testImg'))        .width('500px').height('280px')        .mask(this.progress)        .animation({          duration: 2000, // 动画时长          curve: Curve.Linear, // 动画曲线          delay: 0, // 动画延迟          iterations: 1, // 播放次数          playMode: PlayMode.Normal // 动画模式        }) // 对Button组件的宽高属性进行动画配置      // 更新进度遮罩的进度值      Button('updateProgress')        .onClick((event?: ClickEvent) => {          this.value += 10;          this.progress.updateProgress(this.value);        }).width(200).height(50).margin(20)      // 更新进度遮罩的颜色      Button('updateColor')        .onClick((event?: ClickEvent) => {          if (this.progressflag1) {            this.progress.updateColor(0x9fff0000);          } else {            this.progress.updateColor(0x9f0000ff);          }          this.progressflag1 = !this.progressflag1        }).width(200).height(50).margin(20)      // 恢复进度遮罩      Button('click reset!')        .onClick((event?: ClickEvent) => {          this.value = 0;          this.progress.updateProgress(this.value);        }).width(200).height(50).margin(20)    }    .width('100%')    .margin({ top: 15 })  }}

最后，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（Harmony NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（Harmony NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

 获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（Harmony NEXT）最新学习路线

•  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术
    • 鸿蒙NaPi组件进阶
      • HarmonOS高级技能
        • 初识HarmonOS内核 
        • 实战就业级设备开发

          有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

          获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

          《鸿蒙 (OpenHarmony)开发入门教学视频》

          《鸿蒙生态应用开发V2.0白皮书》

          《鸿蒙 (OpenHarmony)开发基础到实战手册》

          OpenHarmony北向、南向开发环境搭建

           《鸿蒙开发基础》

          • ArkTS语言
          • 安装DevEco Studio
          • 运用你的第一个ArkTS应用
          • ArkUI声明式UI开发
          • .……

             《鸿蒙开发进阶》

            • Stage模型入门
            • 网络管理
            • 数据管理
            • 电话服务
            • 分布式应用开发
            • 通知与窗口管理
            • 多媒体技术
            • 安全技能
            • 任务管理
            • WebGL
            • 国际化开发
            • 应用测试
            • DFX面向未来设计
            • 鸿蒙系统移植和裁剪定制
            • ……

              《鸿蒙进阶实战》

              • ArkTS实践
              • UIAbility应用
              • 网络案例
              • ……

                 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

                总结

                总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。