← 控件(Unit)
控件布局于场景中,如常见的按钮、输入框、文本、标签、列表等都属于控件。每种控件都有其特有的属性设置,以满足不同的需求。
控件自身属性
-
控件名称
name
字符串。
-
控件类型
type
字符串,如BUTTON、TEXTBOX等。
所有控件都具有的属性节点
-
宽度
width
数字,控件宽度。
-
高度
height
数字,控件高度。
-
X坐标
left
数字,控件左边缘与父容器左边缘的距离,单位为像素。
-
Y坐标
top
数字,控件顶部与父容器顶部的距离,单位为像素。
-
文本
text
字符串,与该控件关联的文本内容。
-
显示
visible
true/false,设置控件是否显示。
-
获得焦点
focus
无需赋值,调用则控件获得焦点。
-
字体
fontFamily
字符串,设置控件字体,如宋体。
-
字体大小
fontSize
数字,设置字体大小。
-
背景色
backColor
字符串,颜色代码,如red、#000000、#FF000000等。
-
前景色
foreColor
字符串,颜色代码,如red、#000000、#FF000000等。
-
Tab键顺序
tabIndex
数字,按Tab键切换焦点的顺序。
-
布局类型
dock
控件下边缘停靠在父容器底部Bottom、控件左边缘停靠在父容器左边Left、控件上边缘停靠在父容器顶部Top、控件右边缘停靠在父容器右边Right、控件自动充满父容器Fill、根据left、right、width、height属性手动设置None。
-
锚定类型
anchor
控件锚定到容器的下边缘Bottom、控件锚定到容器的左边缘Left、控件锚定到容器的上边缘Top、控件锚定到容器的右边缘Right、控件不锚定到容器的任何边缘None。
-
外边距
margin
数字,设置控件之间的边距。
-
左外边距
marginLeft
数字,设置控件左边的外边距。
-
上外边距
marginTop
数字,设置控件上边的外边距。
-
右外边距
marginRight
数字,设置控件右边的外边距。
-
下外边距
marginBottom
数字,设置控件下边的外边距。
-
内边距
padding
数字,设置控件内部的边距。
-
左内边距
paddingLeft
数字,设置控件左边的内边距。
-
上内边距
paddingTop
数字,设置控件上边的内边距。
-
右内边距
paddingRight
数字,设置控件右边的内边距。
-
下内边距
paddingBottom
数字,设置控件下边的内边距。
-
点击
click
任务名称,点击控件后执行指定任务。
-
在控件有焦点时释放按键
keyUp
任务名称,在控件有焦点时释放按键时执行指定任务。
-
在控件有焦点时按下按键
keyDown
任务名称,在控件有焦点时按下按键时执行指定任务。
-
在控件有焦点时按下按键
keyPress
任务名称,在控件有焦点时按下按键时执行指定任务。
-
允许拖放
allowDrop
true/false,设置是否允许拖放文件到控件上。
-
拖放完成
dragDrop
任务名称,拖放完成后执行指定任务,前提是允许拖放。拖放文件路径更新到局部变量file中。
-
拖入
dragEnter
任务名称,拖入控件边界时执行指定任务,前提是允许拖放。拖放文件路径更新到局部变量file中。
-
拖入悬浮
dragOver
任务名称,拖放对象悬浮于拖放区域,在拖放区域内移动时多次触发,前提是允许拖放。拖放文件路径更新到局部变量file中。
-
离开拖放区域
dragLeave
任务名称,离开拖放区域时执行指定任务,前提是允许拖放。
-
鼠标进入
mouseEnter
任务名称,鼠标进入控件边界时执行指定任务。
-
鼠标移动
mouseMove
任务名称,鼠标在控件区域移动时执行指定任务。鼠标当前坐标存放到局部变量x和y中,x为横坐标,y为纵坐标。
-
鼠标离开
mouseLeave
任务名称,鼠标离开控件边界时执行指定任务。
容器类型的控件
某些控件可作为容器,如菜单栏、面板等,甚至当需要子菜单时,父菜单项也可以作为容器。控件的name属性以父容器name.(英文句号)开头时,该控件将自动添加到父容器中,比如往菜单栏“菜单”中的“文件”菜单项中添加一个“退出”子菜单项,退出子菜单项的name属性为菜单.文件.退出。