张春 发表于 前天 19:31

鸿蒙API13开辟【卡片PasteButton】ArkTS组件

安全控件的粘贴按钮,用户通过点击该粘贴按钮,可以暂时获取读取剪贴板权限。
说明
该组件从API Version 10开始支持。后续版本如有新增内容,则接纳上角标单独标记该内容的起始版本。
子组件

不支持。
接口

PasteButton

PasteButton()
默认创建带有图标、文本、配景的粘贴按钮。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
PasteButton

PasteButton(options:PasteButtonOptions)
创建包罗指定元素的粘贴按钮。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名类型必填说明options是创建包罗指定元素的粘贴按钮。默认值:{icon: PasteIconStyle.LINES,text: PasteDescription.PASTE,buttonType: ButtonType.Capsule} PasteButtonOptions

用于指定粘贴按钮的图标、文本等指定元素。
说明


[*] icon或text需至少传入一个。
[*] 如果icon、text都不传入,中的options参数不起效,创建的PasteButton为默认样式,默认样式:
PasteIconStyle默认样式为LINES;
PasteDescription默认样式为PASTE;
ButtonType默认样式为Capsule。
[*] icon、text、buttonType不支持动态修改。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称类型必填说明icon否设置粘贴按钮的图标风格。不传入该参数表现没有图标。text否设置粘贴按钮的文本形貌。不传入该参数表现没有笔墨形貌。buttonType否设置粘贴按钮的配景样式。不传入该参数,系统默认提供Capsule类型按钮。 属性

PasteIconStyle枚举说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称值说明LINES0粘贴按钮展示线条样式图标。 PasteDescription枚举说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称值说明PASTE0粘贴按钮的笔墨形貌为“粘贴”。 PasteButtonOnClickResult枚举说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称值说明SUCCESS0粘贴按钮点击乐成。TEMPORARY_AUTHORIZATION_FAILED1粘贴按钮点击后权限授权失败。 事件

不支持通用事件,仅支持以下事件:
onClick

onClick(event: (event: ClickEvent, result: PasteButtonOnClickResult) => void)
点击动作触发该回调
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名类型必填说明event是见ClickEvent对象说明result是剪贴板权限的授权结果,授权后可以读取当前剪贴板内容。 示例

// xxx.ets
@Entry
@Component
struct Index {
build() {
    Row() {
      Column({space:10}) {
      // 默认参数下,图标、文字、背景都存在
      PasteButton().onClick((event: ClickEvent, result: PasteButtonOnClickResult)=>{
          console.info("result " + result)
      })
      // 传入参数即表示元素存在,不传入的参数表示元素不存在,如果不传入buttonType,会默认添加ButtonType.Capsule配置,显示图标+背景。
      PasteButton({icon:PasteIconStyle.LINES})
      // 只显示图标+背景,如果设置背景色高八位的α值低于0x1A,则会被系统强制调整为0xFF
      PasteButton({icon:PasteIconStyle.LINES, buttonType:ButtonType.Capsule})
          .backgroundColor(0x10007dff)
      // 图标、文字、背景都存在,如果设置背景色高八位的α值低于0x1A,则会被系统强制调整为0xFF
      PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
      // 图标、文字、背景都存在,如果设置宽度小于当前属性组合下允许的最小宽度时,宽度仍为设置值,此时按钮文本信息会自动换行,以保证安全控件显示的完整性。
      PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
          .fontSize(16)
          .width(30)
      // 图标、文字、背景都存在,如果设置宽度小于当前属性组合下允许的最小宽度时,宽度仍为设置值,此时按钮文本信息会自动换行,以保证安全控件显示的完整性。
      PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
          .fontSize(16)
          .size({width: 30, height: 30})
      // 图标、文字、背景都存在,如果设置宽度小于当前属性组合下允许的最小宽度时,宽度仍为设置值,此时按钮文本信息会自动换行,以保证安全控件显示的完整性。
      PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
          .fontSize(16)
          .constraintSize({minWidth: 0, maxWidth: 30, minHeight: 0, maxHeight: 30})
      }.width('100%')
    }.height('100%')
}
}
https://i-blog.csdnimg.cn/direct/3063617cfd154e4a98e445cfc8d54e61.png

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: 鸿蒙API13开辟【卡片PasteButton】ArkTS组件