类: TouchToolStrip

Sheets.Touch.TouchToolStrip

Table of contents

构造方法

• constructor

方法

• add
• clear
• close
• getItem
• getItems
• imageAreaHeight
• itemHeight
• itemWidth
• open
• remove
• separatorHeight

构造方法

constructor

• new TouchToolStrip(workbook, host)

工具栏

参数

属性名	类型	说明
workbook	Workbook	Spread对象
host	HTMLElement	宿主DOM元素

方法

add

▸ add(item): void

将项添加到触摸工具栏

remarks 要添加的项可以是工具栏项或行分隔符

代码示例

//本示例添加一个自定义项
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("C", "Delete", "tsoutline.png", function(){ }))
spread.touchToolStrip.getItem("C").font("15px Arial").foreColor("red");
spread.touchToolStrip.imageAreaHeight(30);
spread.touchToolStrip.itemHeight(80);
spread.touchToolStrip.itemWidth(50);
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());

参数

属性名	类型	说明
item	TouchToolStripSeparator | TouchToolStripItem	要添加的项

返回值

void

---

clear

▸ clear(): void

清除工具栏中的所有项

代码示例

//本示例使用clear方法
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("C", "Delete", "tsoutline.png", function(){ }))
spread.touchToolStrip.getItem("C").font("15px Arial").foreColor("red");
spread.touchToolStrip.imageAreaHeight(30);
spread.touchToolStrip.itemHeight(80);
spread.touchToolStrip.itemWidth(50);
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());
spread.touchToolStrip.clear();

返回值

void

---

close

▸ close(): void

关闭工具栏

返回值

void

---

getItem

▸ getItem(name): any

获取具有指定名称的项

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("Cut", "Delete", "cut.png", function(){ }))
spread.touchToolStrip.getItem("Cut").font("15px Arial").foreColor("red");
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());

参数

属性名	类型	说明
name	string	项名称

返回值

any

如果该项存在于工具栏中，则返回该项；否则，返回undefined

---

getItems

▸ getItems(): any

获取属于工具栏的所有项

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("OP1", "OP1", "op1.png", function(){ }))
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("OP2", "OP2", "op2.png", function(){ }))
// Gets all the items that belong to the toolbar.
console.log(spread.touchToolStrip.getItems());

返回值

any

包含工具栏中所有项的数组

---

imageAreaHeight

▸ imageAreaHeight(height?): any

获取或设置图像区域的高度

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("C", "Delete", "tsoutline.png", function(){ }))
spread.touchToolStrip.getItem("C").font("15px Arial").foreColor("red");
spread.touchToolStrip.imageAreaHeight(30);
spread.touchToolStrip.itemHeight(80);
spread.touchToolStrip.itemWidth(50);
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());

参数

属性名	类型	说明
height?	number	图像区域的高度

返回值

any

如果未设置任何值，则返回图像区域的高度；否则，返回工具栏

---

itemHeight

▸ itemHeight(height?): any

获取或设置工具栏项的高度

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("C", "Delete", "tsoutline.png", function(){ }))
spread.touchToolStrip.getItem("C").font("15px Arial").foreColor("red");
spread.touchToolStrip.imageAreaHeight(30);
spread.touchToolStrip.itemHeight(80);
spread.touchToolStrip.itemWidth(50);
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());

参数

属性名	类型	说明
height?	number	工具栏项的高度

返回值

any

如果未设置任何值，则返回工具栏项的高度；否则，返回工具栏

---

itemWidth

▸ itemWidth(width?): any

获取或设置工具栏项的宽度

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("C", "Delete", "tsoutline.png", function(){ }))
spread.touchToolStrip.getItem("C").font("15px Arial").foreColor("red");
spread.touchToolStrip.imageAreaHeight(30);
spread.touchToolStrip.itemHeight(80);
spread.touchToolStrip.itemWidth(50);
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());

参数

属性名	类型	说明
width?	number	工具栏项的宽度

返回值

any

如果未设置任何值，则返回工具栏项的宽度；否则，返回工具栏

---

open

▸ open(x, y): void

在相对于触摸点的特定位置打开工具栏

参数

属性名	类型	说明
x	number	x坐标
y	number	y坐标

返回值

void

---

remove

▸ remove(name): TouchToolStripItem

删除具有指定名称的工具栏项

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("Cut", "Delete", "cut.png", function(){ }))
spread.touchToolStrip.getItem("Cut").font("15px Arial").foreColor("red");
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());
spread.touchToolStrip.remove("Cut");
activeSheet.resumePaint();
activeSheet.repaint();

参数

属性名	类型	说明
name	string	被删除项的名称

返回值

TouchToolStripItem

删除项

---

separatorHeight

▸ separatorHeight(height?): any

获取或设置工具栏分隔符的高度

代码示例

spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("Cut", "Delete", "cut.png", function(){ }))
spread.touchToolStrip.getItem("Cut").font("15px Arial").foreColor("red");
spread.touchToolStrip.separatorHeight(33);
spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripSeparator());

参数

属性名	类型	说明
height?	number	工具栏分隔符的高度

返回值

any

如果未设置任何值，则返回工具栏分隔符的高度；否则，返回工具栏