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

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

不支持。
接口

PasteButton

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

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

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

• icon或text需至少传入一个。
  
• 如果icon、text都不传入，[PasteButton]中的options参数不起效，创建的PasteButton为默认样式，默认样式：
  PasteIconStyle默认样式为LINES；
  PasteDescription默认样式为PASTE；
  ButtonType默认样式为Capsule。
  
• icon、text、buttonType不支持动态修改。
  

元服务API： 从API version 11开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
名称类型必填说明icon[PasteIconStyle]否设置粘贴按钮的图标风格。不传入该参数表现没有图标。text[PasteDescription]否设置粘贴按钮的文本形貌。不传入该参数表现没有笔墨形貌。buttonType[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]是见ClickEvent对象说明result[PasteButtonOnClickResult]是剪贴板权限的授权结果，授权后可以读取当前剪贴板内容。 示例

1. // xxx.ets
2. @Entry
3. @Component
4. struct Index {
5.   build() {
6.     Row() {
7.       Column({space:10}) {
8.         // 默认参数下，图标、文字、背景都存在
9.         PasteButton().onClick((event: ClickEvent, result: PasteButtonOnClickResult)=>{
10.           console.info("result " + result)
11.         })
12.         // 传入参数即表示元素存在，不传入的参数表示元素不存在，如果不传入buttonType，会默认添加ButtonType.Capsule配置，显示图标+背景。
13.         PasteButton({icon:PasteIconStyle.LINES})
14.         // 只显示图标+背景，如果设置背景色高八位的α值低于0x1A，则会被系统强制调整为0xFF
15.         PasteButton({icon:PasteIconStyle.LINES, buttonType:ButtonType.Capsule})
16.           .backgroundColor(0x10007dff)
17.         // 图标、文字、背景都存在，如果设置背景色高八位的α值低于0x1A，则会被系统强制调整为0xFF
18.         PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
19.         // 图标、文字、背景都存在，如果设置宽度小于当前属性组合下允许的最小宽度时，宽度仍为设置值，此时按钮文本信息会自动换行，以保证安全控件显示的完整性。
20.         PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
21.           .fontSize(16)
22.           .width(30)
23.         // 图标、文字、背景都存在，如果设置宽度小于当前属性组合下允许的最小宽度时，宽度仍为设置值，此时按钮文本信息会自动换行，以保证安全控件显示的完整性。
24.         PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
25.           .fontSize(16)
26.           .size({width: 30, height: 30})
27.         // 图标、文字、背景都存在，如果设置宽度小于当前属性组合下允许的最小宽度时，宽度仍为设置值，此时按钮文本信息会自动换行，以保证安全控件显示的完整性。
28.         PasteButton({icon:PasteIconStyle.LINES, text:PasteDescription.PASTE, buttonType:ButtonType.Capsule})
29.           .fontSize(16)
30.           .constraintSize({minWidth: 0, maxWidth: 30, minHeight: 0, maxHeight: 30})
31.       }.width('100%')
32.     }.height('100%')
33.   }
34. }

复制代码

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