订阅图表事件
图表功能
保存/加载图表
- onContextMenu(callback)
对话框
定制
交易终端特制" level="1">交易终端特制
多图表布局" level="1">多图表布局
也可以看看

Remark: 请注意，只有在onChartReady回调触发后才可以调用这些方法。所以常见的做法就是这样：

Methods

订阅图表事件

: function()

当图表初始化并准备就绪时，图表库将调用提供的回调。你可以从这一刻安全地调用所有其他方法。

onGrayedObjectClicked(callback)

callback: function(subject)
1. subject: object{type, name}
  1. type:drawing|study
  2. name: string, 被点击的主题名称

每次用户点击灰色的对象时，图表库都会调用此回调函数。例：

new TradingView.widget({
    drawings_access: {
        type: "black",
        tools: [
            { name: "Regression Trend" },
            { name: "Trend Angle", grayed: true },
        ]
    },
    studies_access: {
        type: "black",
        tools: [
            { name: "Aroon" },
            { name: "Balance of Power", grayed: true },
        ]
    },
    <...> // other widget settings
});
widget.onChartReady(function() {
    widget.onGrayedObjectClicked(function(data) {
        // 当您尝试创建力量平衡研究或趋势图形时
        // 此方法将被调用
        alert(data.name + " is grayed out!");
    })
});

onShortcut(shortcut, callback)

shortcut
callback: function(data)

每当按下快捷键时，图书馆将会调用此回调。

例:

event: can be

2.callback: function(arguments)

当GUI事件发生时，图表库将调用回调。每个事件都可以有不同的参数。

unsubscribe(event, callback)

取消订阅特定事件 (即上表中的事件之一) 。

图表功能

chart()

返回图表对象，可用于调用Chart-Methods

setLanguage(locale)

locale
:
language code

设置Widget的语言。目前此调用将重新加载图表。请避免使用它。

setSymbol(symbol, interval, callback)

symbol: string
interval: string
callback: function()

使图表更改其商品和分辨率。新商品的数据到达后调用回调。

remove()

从您的页面中删除widget。

closePopupsAndDialogs()

调用此方法会关闭上下文菜单或对话框（如果已显示）。

selectLineTool(drawingId)

drawingId: 可以为一个或
1. cursor
2. dot
3. arrow_cursor
4. eraser
5. measure
6. brush

选择与绘图按钮上的单击相同的图形或光标。

selectedLineTool()

返回所选图形或光标的（见上文）。

### takeScreenshot()

此方法创建图表的快照并将其上传到服务器。

完成后, 调用回调函数。

快照的 URL 将作为参数传递给回调函数。

### lockAllDrawingTools()

此方法返回一个 object
对象, 可用于读取/设置/监视 “锁定所有绘图工具” 按钮的状态。

保存/加载图表

save(callback)

callback: function(object)

将图表状态保存到JS对象。图表库将调用您的回调函数并将状态对象作为参数传递。这个调用是一部分低级别的save/load API.

load(state)

state: object

从状态对象加载图表。这个调用是一部分低级别的save/load API.

getSavedCharts(callback)

callback: function(objects)

is an array of:

id
name
image_url
modified_iso
short_symbol
interval

loadChartFromServer(chartRecord)

chartRecord是您使用 的对象

从服务器加载并显示图表。

saveChartToServer(onCompleteCallback, onFailCallback, saveAsSnapshot, options)

onCompleteCallback: function()
onFailCallback: function()
saveAsSnapshot: should be alwaysfalse
options: object{ chartName }
1. chartName: 图表名称。应指定新图表并重命名。
2. defaultChartName: 图表的默认名称。如果当前图表没有名称，它将被使用。

将当前图表保存到服务器。

removeChartFromServer(chartId, onCompleteCallback)

chartId:调用getSavedCharts(callback)后获得的id
onCompleteCallback: function()

从服务器移除图表。

Custom UI Controls

onContextMenu(callback)

callback: function(unixtime, price). 此回调将返回一个值（见下文）。

当用户打开图表上的菜单时，库将调用回调函数。UNIX时间和菜单点的价格将作为参数提供。要自定义菜单项，您必须返回项目描述数组。项目描述对象具有以下结构：

{
    position: 'top' | 'bottom',
    text: 'Menu item text',
    click: <onItemClicked callback>
}

position: 项目在菜单中的位置
text: 菜单项文本
click: 当用户选择您的菜单项时将被调用

添加分隔符使用减号。例:{ text: "-", position: "top" }.

要从菜单中删除现有项目，请在项目文本前面使用减号。例:{ text: "-Objects Tree..." }

例:

createButton(options)

options: object{ align: "left" }
1. align: “right” | “left”. default: “left”

在图表顶部工具栏中创建一个新的DOM元素，并返回此按钮的jQuery对象。您可以使用它直接在图表上附加自定义控件。例：

widget.onChartReady(function() {
    widget.createButton()
        .attr('title', "My custom button tooltip")
        .on('click', function (e) { alert("My custom button pressed!"); })
        .append($('<span>My custom button caption</span>'));
});

对话框

Since 1.6 version

showNoticeDialog(params)

params: 对象:
1. title: 标题
2. body: 正文
3. callback: 当按下ok按钮时调用的函数。

此方法显示一个对话框，其中包含自定义标题和文本以及“确定”按钮。

showConfirmDialog(params)

params: 对象:
1. title: 标题
2. body: 正文
3. callback(result): 当按下ok按钮时调用的函数。
  result点击ok时为true, 否则为false。

此方法显示一个带有自定义标题和文本以及”确定”、”取消”按钮的对话框。

showLoadChartDialog()

显示加载图表对话框。

showSaveAsChartDialog()

显示另存为…图表对话框。

Getters

symbolInterval(callback)

callback: function(result)
1. result: object{symbol, interval}

由于1.4开始方法会立即返回结果。回调是为了保证兼容性。

图表库将调用回调函数，参数对象包含图表商品和时间间隔。

mainSeriesPriceFormatter()

返回一个带有format方法的对象，用来批量格式化价格。被引入在1.5.

getIntervals()

返回支持的分辨率数组。被引入在1.7.

getStudiesList()

返回全部技术指标数组，您可以通过它们创建技术指标指示器。

定制

addCustomCSSFile(url)

url 绝对或相对路径的文件夹

该方法在版本1.3中引入。从1.4开始，使用custom_css_url替代。

applyOverrides(overrides)

该方法在版本1.5中引入

overrides为一个对象，和overrides相同。

此方法在不重新加载图表的情况下将覆盖应用属性。

applyStudiesOverrides(overrides)

该方法在版本1.9中引入

overrides 为一个对象，和studies_overrides相同。

交易终端特制

以下方法只在交易终端可用.

watchList()