[]
• new StatusItem(name
, options?
)
状态项的基类提供基本值显示和相关的上下文菜单项功能
代码示例
let StatusItem = GC.Spread.Sheets.StatusBar.StatusItem;
let labelItem = new StatusItem('labelItem', {menuContent: 'label', value: 'text'});
属性名 | 类型 | 说明 |
---|---|---|
name |
string |
名称是唯一标识符,在上下文菜单和状态栏中需要 |
options? |
IStatusItemOptions |
- |
▸ onBind(context
): void
绑定上下文。可以重写以添加与上下文相关的事件监听
override
代码示例
LabelItem.prototype.onBind = function (context) {
// 关于上下文做一些事请
}
属性名 | 类型 | 说明 |
---|---|---|
context |
Workbook |
执行上下文 |
void
▸ onCreateItemView(container
): void
在状态栏上创建item元素。可以覆盖自定义项
override
代码示例
let StatusItem = GC.Spread.Sheets.StatusBar.StatusItem;
function LabelItem (name, options) {
StatusItem.call(this, name, options);
}
LabelItem.prototype = new StatusItem();
LabelItem.prototype.onCreateItemView = function (container) {
let item = document.createElement('div');
item.innerText = this.value;
container.appendChild(item);
// 为容器添加事件监听器
}
statusBar.add(new LabelItem('labelItem', {menuContent: 'label', value: 'options test'}));
属性名 | 类型 |
---|---|
container |
HTMLElement |
void
▸ onDispose(): void
将状态栏部署为解除绑定上下文,删除所有监听并部署所有元素
override
代码示例
let StatusItem = GC.Spread.Sheets.StatusBar.StatusItem;
function LabelItem (name, options) {
StatusItem.call(this, name, options);
}
LabelItem.prototype = new StatusItem();
LabelItem.prototype.onDispose = function () {
// 部署当前项
// 然后调用超级部署
StatusItem.prototype.onDispose.call(this);
}
void
▸ onUnbind(): void
取消绑定上下文。可以重写以删除与上下文相关的事件监听
override
代码示例
LabelItem.prototype.onUnbind = function () {
// 删除与上下文相关的事件监听
}
void
▸ onUpdate(content?
): void
可以在其中实现与更新相关的操作当当前项需要更新时,用户应该调用onUpdate 可以在其中实现与更新相关的操作当当前项需要更新时,用户应该调用onUpdate 在超类中的默认操作是可见地更新当前项
override
代码示例
let StatusItem = GC.Spread.Sheets.StatusBar.StatusItem;
function LabelItem (name, options) {
StatusItem.call(this, name, options);
}
LabelItem.prototype = new StatusItem();
LabelItem.prototype.onUpdate = function () {
StatusItem.prototype.onUpdate.call(this);
// 更新项
属性名 | 类型 | 说明 |
---|---|---|
content? |
string |
要显示在 StatusItem 上的字符串内容 |
void