[]
Sheets.CellTypes.RadioButtonList
↳ RadioButtonList
• new RadioButtonList()
一个可编辑的单选按钮列表单元格
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
activeSheet.getCell(2, 2).cellType(cellType2);
• typeName: string
支持序列化的类型名称字符串
▸ activateEditor(editorContext
, cellStyle
, cellRect
, context?
): void
激活编辑器,包括为编辑器设置属性或属性以及为编辑器绑定事件
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
cellStyle |
Style |
单元格的实际样式 |
cellRect |
Rect |
单元格的布局信息 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ boxSize(value?
): any
获取或设置单选按钮的大小,仅支持数字和"auto"
代码示例
// 本示例创建单选列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.boxSize(20);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
string | number |
单选按钮的大小如果该值为"auto",单选按钮的大小将随字体大小而变化 |
any
如果未设置值,则返回单选按钮的大小否则,返回单选列表单元格类型
▸ createEditorElement(context?
): HTMLElement
创建一个DOM元素,然后返回
属性名 | 类型 | 说明 |
---|---|---|
context? |
any |
与单元格类型关联的上下文 |
HTMLElement
创建一个DOM元素,然后返回
▸ deactivateEditor(editorContext
, context?
): void
停用编辑器,例如解除绑定编辑器事件
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ direction(value?
): any
获取或设置单选按钮列表的顺序
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.direction(GC.Spread.Sheets.CellTypes.Direction.vertical);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
Direction |
顺序是垂直的 |
any
如果未设置任何值,则返回单选按钮列表的顺序是否垂直;否则,返回单选按钮列表cellType
▸ focus(editorContext
, context?
): void
关注编辑器DOM元素
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ format(value
, format
, formattedData?
, context?
): string
将具有指定格式的值格式化为字符串
属性名 | 类型 | 说明 |
---|---|---|
value |
any |
要格式化的对象值 |
format |
string | GeneralFormatter |
格式化 |
formattedData? |
FormattedData |
格式化的数据 |
context? |
any |
与单元格类型关联的上下文 |
string
返回格式化的字符串
▸ fromJSON(settings
): void
从指定的JSON字符串加载对象状态
属性名 | 类型 | 说明 |
---|---|---|
settings |
any |
反序列化的单元格类型数据 |
void
▸ getAutoFitHeight(value
, text
, cellStyle
, zoomFactor
, context?
): number
获取单元格的高度,该高度可用于处理该行的自适应
属性名 | 类型 | 说明 |
---|---|---|
value |
any |
单元格的值 |
text |
string |
单元格的文本 |
cellStyle |
Style |
单元格的实际值 |
zoomFactor |
number |
当前表单的缩放系数 |
context? |
any |
与单元格类型关联的上下文 |
number
返回单元格的高度,该高度可用于处理行的自适应
▸ getAutoFitWidth(value
, text
, cellStyle
, zoomFactor
, context?
): number
获取可用于处理列的自适应的单元格宽度
属性名 | 类型 | 说明 |
---|---|---|
value |
any |
单元格的值 |
text |
string |
单元格的文本 |
cellStyle |
Style |
单元格的实际值 |
zoomFactor |
number |
当前表单的缩放系数 |
context? |
any |
与单元格类型关联的上下文 |
number
返回单元格的高度,该高度可用于处理列的自适应
▸ getEditorValue(editorContext
, context?
): any
获取编辑器的值
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
context? |
any |
与单元格类型关联的上下文 |
any
返回编辑器的值
▸ getHitInfo(x
, y
, cellStyle
, cellRect
, context?
): IHitTestCellTypeHitInfo
获取单元格类型的匹配信息
属性名 | 类型 | 说明 |
---|---|---|
x |
number |
指针相对于画布的当前位置的 x 坐标 |
y |
number |
指针相对于画布的当前位置的 y 坐标 |
cellStyle |
Style |
当前单元格的实际样式 |
cellRect |
Rect |
当前单元格的布局信息 |
context? |
any |
与单元格类型关联的上下文 |
返回包含 x , y , row , col , cellRect 的对象 ,以及 sheetArea 参数,以及一个表示 isReservedLocation 的值
如果命中测试位于单元格类型需要处理的特殊区域中,则 isReservedLocation 为true
否则为false
▸ isEditingValueChanged(oldValue
, newValue
, context?
): boolean
编辑值是否已更改
属性名 | 类型 | 说明 |
---|---|---|
oldValue |
any |
旧的编辑值 |
newValue |
any |
新的编辑值 |
context? |
any |
与单元格类型关联的上下文 |
boolean
如果oldValue等于newValue,为true
;否则为false
▸ isFlowLayout(value?
): any
获取或设置单选按钮列表的布局为自动调整
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.isFlowLayout(true);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
boolean |
布局是否为自动调整 |
any
如果未设置任何值,则返回布局是否为自动调整,返回单选按钮列表cellType
▸ isImeAware(context?
): boolean
此单元格类型是否存在IME
属性名 | 类型 | 说明 |
---|---|---|
context? |
any |
与单元格类型关联的上下文 |
boolean
如果单元格类型存在IME,为true
;否则为false
▸ isReservedKey(e
, context?
): boolean
单元格类型是否处理键盘事件本身
属性名 | 类型 | 说明 |
---|---|---|
e |
KeyboardEvent |
键盘事件 |
context? |
any |
与单元格类型关联的上下文 |
boolean
如果单元格类型处理键盘事件本身,则返回true
;否则,返回false 否则为false
▸ itemSpacing(value?
): any
获取或设置单选按钮列表中两个项的空间
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.itemSpacing({
horizontal:80,
vertical:20
});
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
IItemSpacing |
单选按钮列表中两个项的空间 |
any
如果未设置任何值,则返回单选按钮列表中两项的空格;否则,返回单选按钮列表cellType
▸ items(items?
): any
获取或设置radio-button的项目
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
items? |
string [] | ICelltypeItemOption [] |
单选按钮列表的项 |
any
如果没有设置值,则返回items数组;否则,返回单选按钮列表cellType
▸ maxColumnCount(value?
): any
获取或设置单选按钮列表的列数的项
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.maxColumnCount(2);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
number |
单选按钮列表的列数 |
any
如果未设置任何值,则返回列数 否则,返回单选按钮列表cellType
▸ maxRowCount(value?
): any
获取或设置单选按钮列表的行数的项
代码示例
//本示例创建单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.maxRowCount(2);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
number |
单选按钮列表的行数 |
any
如果未设置任何值,则返回行数;否则,返回单选按钮列表cellType
▸ paint(ctx
, value
, x
, y
, w
, h
, style
, context?
): void
在画布上绘制一个单元格
属性名 | 类型 | 说明 |
---|---|---|
ctx |
CanvasRenderingContext2D |
画布的二维上下文 |
value |
any |
单元格的值 |
x |
number |
x 相对于画布的坐标 |
y |
number |
相对于画布的 y 坐标 |
w |
number |
单元格的宽度 |
h |
number |
单元格的高度 |
style |
Style |
单元格的实际样式 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ paintContent(ctx
, value
, x
, y
, w
, h
, style
, context?
): void
在画布上绘制单元格内容区域
属性名 | 类型 | 说明 |
---|---|---|
ctx |
CanvasRenderingContext2D |
画布的二维上下文 |
value |
any |
单元格的值 |
x |
number |
x 相对于画布的坐标 |
y |
number |
相对于画布的 y 坐标 |
w |
number |
单元格内容区域的宽度 |
h |
number |
单元格内容区域的高度 |
style |
Style |
单元格的实际样式 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ parse(text
, formatStr
, context?
): any
将具有指定格式字符串的文本解析为对象
属性名 | 类型 | 说明 |
---|---|---|
text |
string |
解析文本字符串 |
formatStr |
string |
解析格式字符串 |
context? |
any |
与单元格类型关联的上下文 |
any
解析对象
▸ processKeyDown(event
, context?
): boolean
在显示模式下处理按键
属性名 | 类型 | 说明 |
---|---|---|
event |
KeyboardEvent |
键盘事件 |
context? |
any |
与单元格类型关联的上下文 |
boolean
如果过程成功,则返回true
;否则为false
▸ processKeyUp(event
, context?
): boolean
在显示模式下处理按键
属性名 | 类型 | 说明 |
---|---|---|
event |
KeyboardEvent |
键盘事件 |
context? |
any |
与单元格类型关联的上下文 |
boolean
如果过程成功,则返回true
;否则为false
▸ processMouseDown(hitInfo
): boolean
在显示模式下向下处理鼠标
属性名 | 类型 | 说明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfo方法返回的命中测试信息 |
boolean
如果过程成功,则返回true
;否则为false
▸ processMouseEnter(hitInfo
): boolean
在显示模式下处理鼠标的输入
属性名 | 类型 | 说明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfo方法返回的命中测试信息 |
boolean
如果过程成功,则返回true
;否则为false
▸ processMouseLeave(hitInfo
): boolean
在显示模式下处理鼠标离开
属性名 | 类型 | 说明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfo方法返回的命中测试信息 |
boolean
如果过程成功,则返回true
;否则为false
▸ processMouseMove(hitInfo
): boolean
在显示模式下处理鼠标移动
属性名 | 类型 | 说明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfo方法返回的命中测试信息 |
boolean
如果过程成功,则返回true
;否则为false
▸ processMouseUp(hitInfo
): boolean
在显示模式下处理鼠标抬起
属性名 | 类型 | 说明 |
---|---|---|
hitInfo |
IHitTestCellTypeHitInfo |
getHitInfo方法返回的命中测试信息 |
boolean
如果过程成功,则返回true
;否则为false
▸ selectAll(editorContext
, context?
): void
选择编辑器DOM元素中的所有文本
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ setEditorValue(editorContext
, value
, context?
): void
设置编辑器的值
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
value |
any |
从活动单元格返回的值 |
context? |
any |
与单元格类型关联的上下文 |
void
▸ textAlign(value?
): any
获取或设置单选按钮位置的文本,仅支持left和right
代码示例
//本示例创建一个单选按钮列表单元格
var cellType2 = new GC.Spread.Sheets.CellTypes.RadioButtonList();
cellType2.items([{text:"a",value:1},{text:"b",value:2},{text:"c",value:3}]);
cellType2.textAlign(GC.Spread.Sheets.CellTypes.TextAlign.left);
activeSheet.getCell(2, 2).cellType(cellType2);
属性名 | 类型 | 说明 |
---|---|---|
value? |
TextAlign |
单选按钮位置的文本 |
any
如果未设置任何值,则返回单选按钮位置的文本,返回单选按钮列表cellType
▸ toJSON(): any
将对象状态保存为JSON字符串
any
单元格类型数据
▸ updateEditor(editorContext
, cellStyle
, cellRect
, context?
): Rect
更新编辑器的大小
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
cellStyle |
Style |
单元格的实际样式 |
cellRect |
Rect |
单元格的布局信息 |
context? |
any |
与单元格类型关联的上下文 |
返回单元格包装器元素的新大小,它应包含两个属性"width"和 "height"
▸ updateEditorContainer(editorContext
, editorBounds
, cellStyle
): void
更新单元格wrapper元素的大小
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
editorBounds |
Rect |
单元格wrapper元素的新大小 |
cellStyle |
Style |
单元格的实际样式 |
void
▸ updateImeMode(editorContext
, imeMode
, context?
): void
更新编辑器的ime模式
属性名 | 类型 | 说明 |
---|---|---|
editorContext |
HTMLElement |
由createEditorElement方法创建的DOM元素 |
imeMode |
ImeMode |
单元格实际样式中的ime模式 |
context? |
any |
与单元格类型关联的上下文 |
void