对 Button 组件使用样式

您可以设置样式属性来更改按钮实例的外观。如果样式属性的名称以"Color"结尾,则它是颜色样式属性,并且行为与非颜色样式属性不同。有关更多信息,请参见"使用组件"中的使用样式自定义组件的颜色和文本

Button 组件支持下列样式:

样式

主题

说明

themeColor

光晕

组件的基本配色方案。可能的值包括 "haloGreen""haloBlue""haloOrange"。默认值为 "haloGreen"

backgroundColor

范例

背景色。默认值为 0xEFEBEF(浅灰)。

在"光晕"主题中,按钮弹起时使用 0xF8F8F8(极浅灰)作为其背景颜色,按钮按下时使用 themeColor 作为其背景颜色。在"光晕"主题中设置按钮的外观只能修改按钮弹起时的背景颜色。请参见对 Button 组件使用外观

borderStyle

范例

在"范例"主题中,Button 组件使用 RectBorder 实例作为其边框并对在该类上定义的样式做出响应。请参见RectBorder 类

在"光晕"主题中,Button 组件使用自定义的圆角边框,该边框的颜色除 themeColor 外都不能修改。

color

光晕和范例

文本颜色。"光晕"主题的默认值为 0x0B333C,"范例"主题的默认值为空白。

disabledColor

光晕和范例

组件禁用时的文本颜色。默认值为 0x848384(深灰)。

embedFonts

光晕和范例

一个布尔值,它指示在 fontFamily 中指定的字体是否为嵌入字体。如果 fontFamily 引用了嵌入字体,则此样式必须设置为 true。否则,将不使用该嵌入字体。如果此样式设置为 true,并且 fontFamily 不引用嵌入字体,则不会显示任何文本。默认值为 false

fontFamily

光晕和范例

文本的字体名称。默认值为 "_sans"

fontSize

光晕和范例

字体的磅值。默认值为 10。

fontStyle

光晕和范例

字体样式:"normal""italic"。默认值为 "normal"

fontWeight

光晕和范例

字体粗细:"none""bold"。默认值为 "none"。在调用 setStyle() 期间,所有组件还可以接受值 "normal" 来代替 "none",但随后对 getStyle() 的调用将返回 "none"

textDecoration

光晕和范例

文本修饰:"none""underline"。默认值为 "none"