小工具 "CheckBox "允许在 真 和 假之间选择数值 ，并触发相关事件。
这个小部件有多点触摸功能。更多信息，请参阅 多点触摸功能。
zIndex, left, top, height, width, maxHeight, minHeight, maxWidth, minWidth
外观
|
|
Editor |
Web browser |
Properties
Type |
说明 |
Bindable |
Necessary |
Default value |
|
boxSize |
定义方框图标的大小。 |
|
|
25 |
|
breakWord |
定义一个没有空格的字符串如果太长，是否可以从中间分割开来。 如果 multiLine 被设置为 false，这个选项就没有作用 。欲了解更多信息，请看 这里。 |
|
|
false |
|
checkedBoxImage |
当小组件被按下时显示的图片的相对路径。 当 uncheckedBoxImage 没有设置时，这个选项没有效果 。 更多信息，请看 这里。 |
|
|
|
|
disabledCheckedBoxImage |
当小组件被按下并禁用时，显示图像的相对路径。 当 uncheckedBoxImage没有被 设置时，这个选项没有效果 。 更多信息，请看 这里。 |
|
|
|
|
disabledUncheckedBoxImage |
当小组件未被按下和禁用时显示的图像的相对路径。 当 uncheckedBoxImage没有被 设置时，这个选项没有效果 。 更多信息，请看 这里。 |
|
|
|
|
ellipsis |
定义一个太长的文本是否应该用省略号表示，例如 "这个文本是... "而不是 "这个文本太长"。 欲了解更多信息，请看 这里。 |
|
|
false |
|
定义了小组件的可用性。一个禁用的小组件（enable=false）不会对用户互动做出反应，也不会触发事件。"disabled... "样式在运行时显示。启用 "行为从容器小部件继承到子小部件。 |
|
|
true |
||
imageAlign |
图片相对于文本的位置。更多信息，请看 这里。 (图像=方框) |
|
|
left |
|
静态文本或来自文本系统的文本，只要小部件被按下就会显示。 一个本地化的文本是通过指定$IAT/Textkey来定义的。 |
|
|
|
||
multiLine |
定义文本是否能以多行显示。 如果 "wordWrap "的值 为"true"，如果有必要，在一个词之后或在明确定义的换行处（\n），会在文本中添加一个断句。欲了解更多信息，请看 这里。 |
|
|
false |
|
permissionOperate |
定义了允许使用该部件的角色。对于没有足够权限的角色，小组件不会对用户互动作出反应，也不会触发事件。 |
|
|
|
|
permissionView |
定义允许查看小组件的角色。对于没有足够权限的角色，该小组件是隐藏的。 |
|
|
|
|
对可定制的小组件样式的引用。 |
|
|
default |
||
静态文本或显示在小组件上的文本系统的文本。 一个本地化的文本是通过指定$IAT/Textkey来定义的。 |
|
|
|
||
uncheckedBoxImage |
当小组件未被按下时显示的图像的相对路径。如果这个选项没有被用户设置，一个标准的图像被用于以下属性。 checkedBoxImage, uncheckedBoxImage, disabledCheckedBoxImage, disabledUncheckedBoxImage 欲了解更多信息，请看 这里。 |
|
|
|
|
定义小组件的值（选中= 真，未选中= 假）。 |
|
|
false |
||
定义小组件的可见性。该小组件可以用visible=false来隐藏。 (visible = true, hidden = false）。可见性 "行为从容器小部件继承到子小部件。 |
|
|
true |
||
wordWrap |
定义了如果有必要的话，是否会在一个词之后给文本添加一个断句。 如果 "multiLine "被设置为 false值，这个选项就没有效果 。更多信息，请看 这里。 |
|
|
false |
|
zIndex决定了小组件的z-order。对于重叠的小组件，zIndex决定了哪个小组件在上面，哪个在下面。具有较大zIndex的部件在上面，具有较小zIndex的部件在下面。zIndex在一块内容或一个容器小部件中必须是唯一的。zIndex是由视觉编辑器自动分配的，因此可以通过工具条来改变。 |
|
|
|
||
left |
从被包围的元素（如容器小部件或内容）的左边界测量的绝对位置。 |
|
|
|
|
top |
从被包围元素（如容器部件或内容）的顶部边界测量的绝对位置。 |
|
|
|
|
height |
定义小组件的总高度，单位是像素。 以%为单位的值指的是周围元素的高度。如果该值被设置为 "自动"，高度由内容定义。 |
|
|
30 |
|
width |
定义小组件的总宽度，单位是像素。 如果该值被设置为 "自动"，则宽度由内容定义。 |
|
|
150 |
|
tooltip |
定义当工具提示指示器被按下时应作为信息出现的文本。 你可以使用一个静态文本或来自文本系统的文本。更多信息，请看 这里。 模式 "Tooltip "必须被启用。这有两个不同的选项。 •使用动作 "显示工具提示"。 •使用动作 "客户系统 " ShowTooltips。 |
|
|
|
|
draggable |
定义小组件是否可以在运行时被拖动。这可用于执行行动或建立两个小组件之间的关系。 如果 为真，该小组件可以被移动到另一个小组件上。源小组件保持在其位置，并创建一个副本并拖动。 可以使用OnDragStart 和 OnDragEnd动作 。 如果 是假的，该小组件不能被移动。 更多信息，请看 这里。 |
|
|
false |
|
minWidth |
定义了小组件的最小总宽度。如果 width="auto"，这个属性就会被应用 。值0没有影响。 |
|
|
0 |
|
maxWidth |
定义了小组件的最大总宽度。此属性 在宽度="auto "时应用。值为0没有影响。 |
|
|
0 |
|
minHeight |
定义了小组件的最小总高度。如 果height="auto"，这个属性会 被应用。值为0没有影响。 |
|
|
0 |
|
maxHeight |
定义小组件的最大尺寸。如 果height="auto"，这个属性会 被应用。值为0没有影响。 |
|
|
0 |
|
useSVGStyling |
定义SVG图像是以 "内联 "还是 "对象 "的形式添加到小组件中。如果useSVGStyling = true，SVG属性如imageColor可以在运行时被改变。然而，如果SVG图像包含大量的元素，这可能会影响客户端的性能。如果useSVGStyling = false，属性 imageColor 会被忽略，但在运行时将会更快地显示。 |
|
|
true |
|
tabIndex |
属性tabIndex用于管理键盘操作中的标签顺序。 更多信息请参见 键盘操作。 对于tabIndex≥0的情况，ENTER会触发MouseDown、MouseUp和Click事件。 |
|
|
0 |
Styleable properties
Type |
说明 |
Default value |
|
borderStyle |
定义小组件周围的边框样式。边框可以是不间断的、虚线的或点状的。 |
none |
|
borderWidth |
定义小组件周围边框的宽度。 |
0px |
|
cornerRadius |
定义小组件的角样式。 |
0px |
|
backColor |
定义小组件的背景色。 |
Transparent |
|
disabledBackColor |
定义小组件在禁用状态下的背景颜色。 |
#F1F1F1 |
|
backGroundGradient |
定义小组件的背景色为颜色渐变。 |
|
|
disabledBackGroundGradient |
定义小组件在禁用状态下的背景颜色为颜色渐变。 |
|
|
mouseDownBackGroundGradient |
将小组件的背景色定义为小组件被按下时的颜色渐变。 |
|
|
backGround |
定义一个要用作背景的图像的相对路径。 |
|
|
borderColor |
定义小组件周围边框的颜色。 |
#333 |
|
disabledBorderColor |
定义禁用状态下小组件周围边界的颜色。 |
#CCCCCC |
|
textColor |
定义用于显示文本的颜色。 |
#333 |
|
checkedTextColor |
定义小组件被按下时用于显示文本的颜色。 |
#000000 |
|
disabledTextColor |
定义在禁用状态下文本的颜色。 |
#989898 |
|
disabledCheckedTextColor |
定义小组件被按下和禁用时用于显示文本的颜色。 |
#000000 |
|
mouseDownBorderColor |
定义小组件被按下时小组件的边界颜色。 |
#FF8800 |
|
mouseDownBorderWidth |
定义小组件被按下时，小组件的边界宽度。 |
2px |
|
mouseDownBackColor |
定义小组件被按下时，小组件的背景颜色。 |
Transparent |
|
mouseDownTextColor |
定义当小部件被按下时用于显示文本的颜色。 |
#333333 |
|
textAlign |
定义文本的方向。 |
left |
|
opacity |
定义小组件的透明度。值越低，小组件就越透明。 |
1 |
|
rotation |
定义小组件的旋转，例如，一个90度的值改变小组件顺时针旋转90度。 |
0deg |
|
fontSize |
定义用于显示文本的字体大小。 |
12px |
|
fontName |
定义用于显示文本的字体。 |
Arial |
|
bold |
定义文本是否以粗体显示。 |
true |
|
italic |
定义文本是否以斜体显示。 |
false |
|
padding |
定义小组件的外部边界和其内容之间的间距。欲了解更多信息，请看 这里。 |
0px |
|
margin |
定义小组件的外部边界与小组件的实际设置位置的偏移。更多信息， 请看这里。 |
0px |
|
shadow |
定义小组件的阴影。 |
none |
|
mouseDownShadow |
定义小组件被按下时的小组件的阴影。 |
none |
|
foreColor |
定义方框图标的颜色。这只有在用户没有将自定义的盒子图标添加为图像时才有效果。 |
#FFF |
|
disabledForeColor |
定义禁用状态下的盒子图标的颜色。这仅在用户没有添加自定义方框图标作为图像时才有效果。 |
#FFF |
|
mouseDownForeColor |
定义小组件被按下时方框图标的颜色。 |
#FFF |
|
checkedBoxImageColor |
定义小组件被按下时图像的颜色。这需要一个SVG图像，其颜色没有被明确设置。 |
#000000 |
|
uncheckedBoxImageColor |
定义小组件未被按下时图像的颜色。这需要一个没有明确设置颜色的SVG图像。 |
#000000 |
|
disabledCheckedBoxImageColor |
定义小组件被按下并禁用时的图像颜色。这需要一个没有明确设置颜色的SVG图像。 |
#000000 |
|
disabledUncheckedBoxImageColor |
定义小组件未被按下和禁用时的图像颜色。这需要一个没有明确设置颜色的SVG图像。 |
#000000 |
|
mouseDownBoxBorderColor |
定义小组件被按下时方框的颜色。 |
#FF8800 |