[]
        
(Showing Draft Content)

GC.Spread.Sheets.CellTypes.HyperLink

类: HyperLink

Sheets.CellTypes.HyperLink

继承关系

  • Base

    HyperLink

Table of contents

构造方法

属性

方法

构造方法

constructor

new HyperLink()

超链接单元格

代码示例

var cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FF2235");
cellType.text("GrapeCity Software");
cellType.linkToolTip("Company Web Site");
activeSheet.getCell(1, 1).cellType(cellType).value("http://www.grapecity.com.cn/");
activeSheet.getCell(1, -1).height(30);

代码示例

var cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FF2235");
cellType.text("GrapeCity Software");
cellType.linkToolTip("Company Web Site");
activeSheet.getCell(0, 2).cellType(cellType).value("formula.html");

Overrides

Base.constructor

属性

typeName

typeName: string

支持序列化的类型名称字符串

继承自

Base.typeName

方法

activateEditor

activateEditor(editorContext, cellStyle, cellRect, context?): void

激活编辑器,包括为编辑器设置属性或属性以及为编辑器绑定事件

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
cellStyle Style 单元格的实际样式
cellRect Rect 单元格的布局信息
context? any 与单元格类型关联的上下文

返回值

void

继承自

Base.activateEditor


activeOnClick

activeOnClick(value?): any

获取或设置单击时是否移动到活动单元格

代码示例

//本示例使用activeOnClick方法
var h1 = new GC.Spread.Sheets.CellTypes.HyperLink();
h1.text("GrapeCity Software");
h1.linkToolTip("link to GrapeCity Web page");
h1.linkColor("rgb(0, 100, 200)");
h1.visitedLinkColor("rgb(0, 200, 100)");
h1.activeOnClick(true);
activeSheet.setCellType(1, 1, h1);
activeSheet.getCell(1, 1, GC.Spread.Sheets.SheetArea.viewport).value("http://www.grapecity.com.cn/").hAlign(GC.Spread.Sheets.HorizontalAlign.center);

参数

属性名 类型 说明
value? boolean 单击时是否移动到活动单元格

返回值

any

如果未设置任何值,则返回一个值,该值指示是否移动到活动单元格;否则,返回超链接单元格类型


createEditorElement

createEditorElement(context?): HTMLElement

创建一个DOM元素,然后返回

参数

属性名 类型 说明
context? any 与单元格类型关联的上下文

返回值

HTMLElement

创建一个DOM元素,然后返回

继承自

Base.createEditorElement


deactivateEditor

deactivateEditor(editorContext, context?): void

停用编辑器,例如解除绑定编辑器事件

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
context? any 与单元格类型关联的上下文

返回值

void

继承自

Base.deactivateEditor


focus

focus(editorContext, context?): void

关注编辑器DOM元素

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
context? any 与单元格类型关联的上下文

返回值

void

继承自

Base.focus


format

format(value, format, formattedData?, context?): string

将具有指定格式的值格式化为字符串

参数

属性名 类型 说明
value any 要格式化的对象值
format string | GeneralFormatter 格式化
formattedData? FormattedData 格式化的数据
context? any 与单元格类型关联的上下文

返回值

string

返回格式化的字符串

继承自

Base.format


fromJSON

fromJSON(settings): void

从指定的JSON字符串加载对象状态

参数

属性名 类型 说明
settings any 反序列化的单元格类型数据

返回值

void

继承自

Base.fromJSON


getAutoFitHeight

getAutoFitHeight(value, text, cellStyle, zoomFactor, context?): number

获取单元格的高度,该高度可用于处理该行的自适应

参数

属性名 类型 说明
value any 单元格的值
text string 单元格的文本
cellStyle Style 单元格的实际值
zoomFactor number 当前表单的缩放系数
context? any 与单元格类型关联的上下文

返回值

number

返回单元格的高度,该高度可用于处理行的自适应

继承自

Base.getAutoFitHeight


getAutoFitWidth

getAutoFitWidth(value, text, cellStyle, zoomFactor, context?): number

获取可用于处理列的自适应的单元格宽度

参数

属性名 类型 说明
value any 单元格的值
text string 单元格的文本
cellStyle Style 单元格的实际值
zoomFactor number 当前表单的缩放系数
context? any 与单元格类型关联的上下文

返回值

number

返回单元格的高度,该高度可用于处理列的自适应

继承自

Base.getAutoFitWidth


getEditorValue

getEditorValue(editorContext, context?): any

获取编辑器的值

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
context? any 与单元格类型关联的上下文

返回值

any

返回编辑器的值

继承自

Base.getEditorValue


getHitInfo

getHitInfo(x, y, cellStyle, cellRect, context?): IHitTestCellTypeHitInfo

获取单元格类型的匹配信息

参数

属性名 类型 说明
x number 指针相对于画布的当前位置的 x 坐标
y number 指针相对于画布的当前位置的 y 坐标
cellStyle Style 当前单元格的实际样式
cellRect Rect 当前单元格的布局信息
context? any 与单元格类型关联的上下文

返回值

IHitTestCellTypeHitInfo

返回包含 x , y , row , col , cellRect 的对象 ,以及 sheetArea 参数,以及一个表示 isReservedLocation 的值 如果命中测试位于单元格类型需要处理的特殊区域中,则 isReservedLocation true 否则为false

继承自

Base.getHitInfo


isEditingValueChanged

isEditingValueChanged(oldValue, newValue, context?): boolean

编辑值是否已更改

参数

属性名 类型 说明
oldValue any 旧的编辑值
newValue any 新的编辑值
context? any 与单元格类型关联的上下文

返回值

boolean

如果oldValue等于newValue,为true;否则为false

继承自

Base.isEditingValueChanged


isImeAware

isImeAware(context?): boolean

此单元格类型是否存在IME

参数

属性名 类型 说明
context? any 与单元格类型关联的上下文

返回值

boolean

如果单元格类型存在IME,为true;否则为false

继承自

Base.isImeAware


isReservedKey

isReservedKey(e, context?): boolean

单元格类型是否处理键盘事件本身

参数

属性名 类型 说明
e KeyboardEvent 键盘事件
context? any 与单元格类型关联的上下文

返回值

boolean

如果单元格类型处理键盘事件本身,则返回true;否则,返回false 否则为false

继承自

Base.isReservedKey


linkColor

linkColor(value?): any

获取或设置超链接的颜色

代码示例

//本示例创建一个超链接单元格
cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FF2235");
cellType.text("GrapeCity");
cellType.linkToolTip("Company Web Site");
activeSheet.getCell(1, 1).cellType(cellType).value("http://www.grapecity.com/");
activeSheet.getCell(1, -1).height(30);

参数

属性名 类型 说明
value? string 超链接颜色

返回值

any

如果未设置任何值,则返回超链接颜色;否则,返回hyperLink单元类型


linkToolTip

linkToolTip(value?): any

获取或设置超链接的工具提示

代码示例

//本示例创建一个超链接单元格
cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FF2235");
cellType.text("GrapeCity Software");
cellType.linkToolTip("Company Web Site");
activeSheet.getCell(1, 1).cellType(cellType).value("http://www.grapecity.com.cn/");
activeSheet.getCell(1, -1).height(30);

参数

属性名 类型 说明
value? string 工具提示文字

返回值

any

如果未设置任何值,则返回工具提示文本 否则,返回hyperLink单元类型


onClickAction

onClickAction(value?): any

获取或设置超链接的回调,如果执行,该函数将表示回调的上下文

代码示例

//本示例在选择超链接时设置选项卡颜色
var h2 = new GC.Spread.Sheets.CellTypes.HyperLink();
h2.text("set sheet tab style");
h2.linkToolTip("set sheet tab style");
h2.linkColor("blue");
h2.visitedLinkColor("#FF2235");
activeSheet.getCell(2, 1).cellType(h2).value("set sheet tab style").hAlign(GC.Spread.Sheets.HorizontalAlign.center);
h2.activeOnClick(true);
            h2.onClickAction(function () {
                var setSheetTabColor = {
                    canUndo: true,
                    execute: function (context, options, isUndo) {
                        activeSheet.name("Hyperlink");
                        activeSheet.options.sheetTabColor = "red";
                    }
                };
                var commandManager = spread.commandManager();
                var commandName = "setSheetTabStyle";
                commandManager.register(commandName, setSheetTabColor, null, false, false, false, false);
                commandManager.execute({cmd: commandName})
            });

参数

属性名 类型 说明
value? Function 超链接的回调

返回值

any

如果未设置任何值,则返回一个值,该值指示超链接的回调 否则,返回hyperLink单元格类型


paint

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

继承自

Base.paint


paintContent

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

继承自

Base.paintContent


parse

parse(text, formatStr, context?): any

将具有指定格式字符串的文本解析为对象

参数

属性名 类型 说明
text string 解析文本字符串
formatStr string 解析格式字符串
context? any 与单元格类型关联的上下文

返回值

any

解析对象

继承自

Base.parse


processKeyDown

processKeyDown(event, context?): boolean

在显示模式下处理按键

参数

属性名 类型 说明
event KeyboardEvent 键盘事件
context? any 与单元格类型关联的上下文

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processKeyDown


processKeyUp

processKeyUp(event, context?): boolean

在显示模式下处理按键

参数

属性名 类型 说明
event KeyboardEvent 键盘事件
context? any 与单元格类型关联的上下文

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processKeyUp


processMouseDown

processMouseDown(hitInfo): boolean

在显示模式下向下处理鼠标

参数

属性名 类型 说明
hitInfo IHitTestCellTypeHitInfo getHitInfo方法返回的命中测试信息

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processMouseDown


processMouseEnter

processMouseEnter(hitInfo): boolean

在显示模式下处理鼠标的输入

参数

属性名 类型 说明
hitInfo IHitTestCellTypeHitInfo getHitInfo方法返回的命中测试信息

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processMouseEnter


processMouseLeave

processMouseLeave(hitInfo): boolean

在显示模式下处理鼠标离开

参数

属性名 类型 说明
hitInfo IHitTestCellTypeHitInfo getHitInfo方法返回的命中测试信息

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processMouseLeave


processMouseMove

processMouseMove(hitInfo): boolean

在显示模式下处理鼠标移动

参数

属性名 类型 说明
hitInfo IHitTestCellTypeHitInfo getHitInfo方法返回的命中测试信息

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processMouseMove


processMouseUp

processMouseUp(hitInfo): boolean

在显示模式下处理鼠标抬起

参数

属性名 类型 说明
hitInfo IHitTestCellTypeHitInfo getHitInfo方法返回的命中测试信息

返回值

boolean

如果过程成功,则返回true;否则为false

继承自

Base.processMouseUp


selectAll

selectAll(editorContext, context?): void

选择编辑器DOM元素中的所有文本

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
context? any 与单元格类型关联的上下文

返回值

void

继承自

Base.selectAll


setEditorValue

setEditorValue(editorContext, value, context?): void

设置编辑器的值

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
value any 从活动单元格返回的值
context? any 与单元格类型关联的上下文

返回值

void

继承自

Base.setEditorValue


target

target(value?): any

获取或设置超链接目标的类型

代码示例

//本示例创建一个超链接单元格
var cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FFFF00");
cellType.text("GrapeCity Software");
cellType.linkToolTip("Company Web Site");
cellType.target(GC.Spread.Sheets.CellTypes.HyperLinkTargetType.self);
activeSheet.getCell(0, 2).cellType(cellType).value("http://www.grapecity.com.cn/");

参数

属性名 类型 说明
value? HyperLinkTargetType 超链接的目标类型

返回值

any

如果未设置任何值,则返回超链接的目标类型;否则,返回hyperLink单元类型


text

text(value?): any

获取或设置超链接的文本字符串

代码示例

//本示例创建一个超链接单元格
var cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FFFF00");
cellType.text("GrapeCity Software");
cellType.linkToolTip("Company Web Site");
cellType.target(GC.Spread.Sheets.CellTypes.HyperLinkTargetType.self);
activeSheet.getCell(0, 2).cellType(cellType).value("http://www.grapecity.com.cn/");

参数

属性名 类型 说明
value? string 超链接中显示的文本

返回值

any

如果未设置任何值,则返回超链接中的文本;否则,返回hyperLink单元类型


toJSON

toJSON(): any

将对象状态保存为JSON字符串

返回值

any

单元格类型数据

继承自

Base.toJSON


updateEditor

updateEditor(editorContext, cellStyle, cellRect, context?): Rect

更新编辑器的大小

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
cellStyle Style 单元格的实际样式
cellRect Rect 单元格的布局信息
context? any 与单元格类型关联的上下文

返回值

Rect

返回单元格包装器元素的新大小,它应包含两个属性"width"和 "height"

继承自

Base.updateEditor


updateEditorContainer

updateEditorContainer(editorContext, editorBounds, cellStyle): void

更新单元格wrapper元素的大小

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
editorBounds Rect 单元格wrapper元素的新大小
cellStyle Style 单元格的实际样式

返回值

void

继承自

Base.updateEditorContainer


updateImeMode

updateImeMode(editorContext, imeMode, context?): void

更新编辑器的ime模式

参数

属性名 类型 说明
editorContext HTMLElement 由createEditorElement方法创建的DOM元素
imeMode ImeMode 单元格实际样式中的ime模式
context? any 与单元格类型关联的上下文

返回值

void

继承自

Base.updateImeMode


visitedLinkColor

visitedLinkColor(value?): any

获取或设置访问链接的颜色

代码示例

//本示例创建一个超链接单元格
var cellType = new GC.Spread.Sheets.CellTypes.HyperLink();
cellType.linkColor("blue");
cellType.visitedLinkColor("#FFFF00");
cellType.text("GrapeCity Software");
cellType.linkToolTip("Company Web Site");
cellType.target(GC.Spread.Sheets.CellTypes.HyperLinkTargetType.self);
activeSheet.getCell(0, 2).cellType(cellType).value("http://www.grapecity.com.cn/");

参数

属性名 类型 说明
value? string 访问的链接颜色

返回值

any

如果未设置任何值,则返回访问的链接颜色;否则,返回hyperLink单元类型