harmony 鸿蒙安全控件通用属性

2023-10-30
浏览 (520)

安全控件通用属性

安全控件的基础属性，用于设置安全控件通用的属性。

说明：

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

属性

名称	参数类型	必填	描述
iconSize	Dimension	否	设置安全控件上图标的尺寸。默认值：16vp
layoutDirection	SecurityComponentLayoutDirection	否	设置安全控件上图标和文字分布的方向。默认值：SecurityComponentLayoutDirection.HORIZONTAL
position	Position	否	设置绝对定位，设置安全控件的左上角相对于父容器左上角的偏移位置。默认值： { x: 0, y: 0 }
markAnchor	Position	否	设置安全控件在位置定位时的锚点，以控件左上角作为基准点进行偏移。通常配合position和offset属性使用，单独使用时，效果类似offset 默认值： { x: 0, y: 0 }
offset	Position	否	设置相对定位，安全控件相对于自身的偏移量。默认值： { x: 0, y: 0 }
fontSize	Dimension	否	设置安全控件上文字的尺寸。默认值：16fp
fontStyle	FontStyle	否	设置安全控件上文字的样式。默认值：FontStyle.Normal
fontWeight	number \|FontWeight \|string	否	设置安全控件上文字粗细。默认值：FontWeight.Medium
fontFamily	string \|Resource	否	设置安全控件上文字的字体。默认字体：’HarmonyOS Sans’
fontColor	ResourceColor	否	设置安全控件上文字的颜色。默认值：#ffffffff
iconColor	ResourceColor	否	设置安全控件上图标的颜色。默认值：#ffffffff
backgroundColor	ResourceColor	否	设置安全控件的背景颜色。默认值：#007dff
borderStyle	BorderStyle	否	设置安全控件的边框的样式。默认不设置边框样式
borderWidth	Dimension	否	设置安全控件的边框的宽度。默认不设置边框宽度
borderColor	ResourceColor	否	设置安全控件的边框的颜色。默认不设置边框颜色
borderRadius	Dimension	否	设置安全控件的边框圆角半径。
padding	Padding \|Dimension	否	设置安全控件的内边距。默认值：上下12vp, 左右24vp
textIconSpace	Dimension	否	设置安全控件中图标和文字的间距。默认值：4vp

SecurityComponentLayoutDirection枚举说明

名称	描述
HORIZONTAL	安全控件上图标和文字分布的方向为水平排列。
VERTICAL	安全控件上图标和文字分布的方向为垂直排列。

示例

// xxx.ets
@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        // 生成一个保存按钮，并设置它的SecurityComponent属性
        SaveButton()
          .fontSize(35)
          .fontColor(Color.White)
          .iconSize(30)
          .layoutDirection(SecurityComponentLayoutDirection.HORIZONTAL)
          .borderWidth(1)
          .borderStyle(BorderStyle.Dashed)
          .borderColor(Color.Blue)
          .borderRadius(20)
          .fontWeight(100)
          .iconColor(Color.White)
          .padding({left:50, top:50, bottom:50, right:50})
          .textIconSpace(20)
          .backgroundColor(0x3282f6)
      }.width('100%')
    }.height('100%')
  }
}

zh-cn_image_0000001643038221