同时显示check记号和文本的单元格渲染器。 该渲染器是在editable为true时,可以通过点击鼠标或输入空格键而修改单元格的值的可编辑的渲染器。
Check记号显示true和false以及当threeState为true时的undefined等三种状态。 当通过鼠标或键盘而进行编辑时,将会移动上述三种状态。
该渲染器主要被用于显示和编辑BOOLEAN字段的值,但这并非是必须的。 它分别将指定在falseValues和trueValues的值解释为false和true。 没有被包含在两种属性中的值,将会被视为是通过Boolean而转换类型的值。 如果threeStates为true,就会将undefined、null、空字符串解释为undefined,否则就会解释为false。
通过GridStyles.iconLocation属性值,指定Check记号的显示位置, 并且通过iconOffset属性,设置与单元格边框的间隔, 而通过iconPadding属性,设置Check记号与文本之间的间隔。
如果将editable指定为true,就可以通过点击鼠标,变更单元格的值。 而且,如果spaceKey属性为true,就可以通过输入space键,变更值。 这时,如果threeState为true,值就会循环变更为true -> false -> undefined -> true等三种状态, 否则,就会变更为true -> false -> true等两种状态。 需要注意的是,修改值将会使用通过falseValues或trueValues而指定的值中的第一个值。
如果editOnClick为true,即使通过鼠标而点击的单元格并非聚焦单元格时,也会立即修改值。
当设置列渲染器时,将type指定为"check"。
grid.setColumns([{
name: "Shipping",
fieldName: "Shipping",
renderer: {
type: "check",
editable: true,
dblClickEditable: false,
threeStates: true,
editOnClick: true,
spaceKey: true,
trueValues: "True",
falseValues: "False"
},
header: {
text: "Check Renderer",
styles: {
fontBold: true
}
}
},
...
]);