按钮<Button>

功能概述

按钮标签，在锁屏界面有一块显示区域，能够触发Trigger等一系列的操作和命令，可以通过不同的状态标签来展现对应状态下设置的图片或者文字等。

应用场景

设置好按钮热区，点击该区域，切换壁纸。
滑动热区，播放动画的下一帧。
点击热区，大雨下起或者雪花飘落。
点击热区，花儿绽放。

XML规范

<Button name="" x="" y="" w="" h="" visibility="" longTouchTime="" interceptButtonTouch=""> 
    <Trigger action="" target="" property="" value=""> 
        <Command target="" value=""/> 
    </Trigger> 
    <Trigger action="" target="" property="" value=""/>
    <Normal> 
        <Image/> 
    </Normal>
    <Pressed> 
        <Image/>
        <Text/>
    </Pressed>  
</Button>

参数说明

参数	类型	选项	注释
name	字符串	选填	按钮的名称
visibility	字符串	选填	元素可见性支持表达式<=0 不可见 >0可见
longTouchTime	数值	选填	单位毫秒，设定时间，在长按时间超过一定时间的时候触发Trigger action="long"的命令，默认1000ms
interceptButtonTouch	字符串	选填	判断Button是否已经被触发，若interceptButtonTouch为true，则Button仅能够被触发一次
Trigger	字符串	必填	用来定义按钮、Unlocker、Slider等动作引发相关的操作，可以控制某元素的属性。其规定了触发的动作(action)，并且触发了一系列命令(Command)的执行
Normal	字符串	选填	表示按钮在正常状态时显示的内容，可加入Image，Text，SourceImage，Time，DateTime，ImageNumber，Group
Pressed	字符串	选填	表示按钮在按下状态时显示的内容，可加入内容与Normal相同，区别是Button在正常状态的时候是非激活以及不可见状态。当按钮被按下的时候，Normal状态下的元素都被设置非激活和不可见，而Pressed状态下的元素都设置为激活和可见

Trigger的属性

参数	类型	选项	注释
action	字符串	必填	按钮动作： down (按下), up (抬起), double (双击)，resume（亮屏触发）,pause（熄屏触发），long（长按），click（点击）
target	字符串	必填	控制目标名
property	字符串	选填	属性名，目前支持：visibility 以后会增加其他属性控制。
value	字符串	选填	属性值，目前针对boolean有: true, false, toggle

应用示例

示例一：正常状态下显示白色normal文字和小太阳图片，按下时触发Pressed且显示白色pressed文字和红心图片状态，松开时又恢复正常状态。

<Button name="zk1" x="300" y="300" w="470" h="300"> 
  <Pressed> 
    <Image x="300" y="300" src="ax.png"/> 
    <Text x="300" y="280" text="press" visibility="1"/> 
  </Pressed> 
  <Normal> 
    <Image x="300" y="300" src="ty.png"/> 
    <Text x="300" y="280" text="normal" visibility="1"/> 
  </Normal> 
</Button>

示例二：没点击按钮之前，按钮可见、text文本框显示"可见性：visibility为false，按钮不变"；单击之后，单击按钮不可见、text文本框显示"可见性：visibility为true,按钮消失"。