交易控制器

此页面上的所有内容仅适用于[[交易终端]]。

交易控制器是一种能使您在线交易的东西。其主要目的是将我们的图表与您的交易逻辑连接起来。就JS而言,它是一个 object 以便公开特定的接口。下面是一个终端控制器的方法。

必需的方法

setHost(host)

这种方法在初始化时通过[[交易主机]]传递给控制器。

configFlags()

实现这个方法来提供配置标志对象。结果是具有以下键的对象，即可以true/false:

supportReversePosition

经纪商支持反向交易。
如果经纪商不支持，则图表将具有相反的按钮，但会按相反的顺序排列。
supportClosePosition

经纪商支持平仓。
如果经纪人不支持，图表将会有关闭按钮，但会按顺序排列。
supportReducePosition

经纪商支持在没有订单的情况下更换仓位。
supportPLUpdate

经纪人提供PL的头寸。如果经纪商自己计算利润/损失，它应该调用 [[plUpdate|Trading-Host#plupdatepositionid-pl]] 一旦PL改变了。否则图表将计算PL作为当前交易与头寸平均价格之间的差额。
supportBrackets

经纪支持括号单（获利和止损单）。如果此标志为 true ，则图表将显示仓位的编辑按钮，并将 Edit position... 添加到仓位的上下文菜单。
supportMultiposition

支持多重仓位可防止为反向交易创建默认实现。
supportCustomBottomWidget

此标志可用于使用自定义更改默认的帐户管理器小部件。
showQuantityInsteadOfAmount

该标志可用于在订单对话框中将“金额”更改为“数量”
supportDOM

此标志用来启用DOM小部件。如果 supportLevel2Data 为 false 只有 last price 并且订单将被显示。
supportLevel2Data

Level2数据用于DOM小部件。subscribeDepth 和 unsubscribeDepth 应该被实现。
supportStopLimitOrders

此标志向订单对话框添加止损订单类型。
supportMarketBrackets
使用此标志可以为市场订单禁用括号单。默认情况下启用。
supportEditAmount
此标志可帮助您在编辑现有订单时禁用金额控制。

durations(): array of objects

订单过期期权清单。这是可选的。如果您不希望在订单中显示持续时间，请勿实现。
对象有两个key： { name, value }.

例:

return [{ name: 'DAY', value: 'DAY' }, { name: 'GTC', value: 'GTC' }];

头寸 : Deferred

订单 : Deferred

执行信号(symbol) : Deferred

图表调用这些方法来请求位置/订单/执行并在图表上显示它们。
您应该返回相应的列表[[positions|Trading-Objects-and-Constants#position]], [[orders|Trading-Objects-and-Constants#order]] or [[executions|Trading-Objects-and-Constants#execution]]

supportFloatingPanel()

此方法将返回true,以显示浮动交易面板。

supportBottomWidget()

此方法将返回true,以显示底层交易面板。

chartContextMenuItems(e)

图表可以在上下文菜单中有子菜单 交易 。返回子菜单项的列表。格式是一样的buttondropdownitems。
e 是浏览器传递的上下文对象

bottomContextMenuItems()

底部交易面板可以有一个上下文菜单。返回此菜单的项目列表。格式与 buttonDropdownItems 相同。

isTradable(symbol)

此方法是浮动交易面板所必需的。是否可以访问交易面板取决于这个函数的结果：true或false。如果所有符号都可以交易，则不需要使用此方法。

createBottomWidget(container)

当创建底部交易面板时需要调用这个函数。您应该创建DOM对象并将其附加到 container中。容器在需要时显示一个垂直滚动条。

accountManagerInfo()

当supportCustomBottomWidget为false时，调用此方法。返回用于构建帐户管理器的信息。
有关详细信息，请参阅\ [\ [帐户管理器] ]。

showOrderDialog([[order|Trading-Objects-and-Constants#order]])

当用户请求创建或修改订单时，图表会调用此函数。

所以我们给您一个自己的对话框，它100％由您管理。

placeOrder([[order|Trading-Objects-and-Constants#order]], silently)

当用户想要下订单时调用方法。订单预先填写了部分或全部信息。
如果 silently 为true，则不显示任何对话框。

modifyOrder([[order|Trading-Objects-and-Constants#order]], silently, focus)

order是要修改的订单对象
2.silently - 如果是true，则不显示任何对话框
3.focus - \ [\ [Focus constant \ | Trading-Objects-and-Constants \ #focusoptions ] ]。它可以由图表初始化。

order 是要修改的订单对象
silently - 为 true 时，不显示任何对话框
focus - [[Focus constant|Trading-Objects-and-Constants#focusoptions]]. 它可以由图表初始化。

当用户要修改现有的订单时调用方法。

cancelOrder(orderId, silently)

这个方法被调用来取消指定id的订单。
如果 silently 为true，则不显示任何对话框。

cancelOrders(symbol, side, ordersIds, silently)

symbol - 商品字符串
side: "sell" 或 "buy"
ordersIds - 已经被symbol 和 side 收集的订单id列表
如果 silently 为true，则不显示任何对话框。

此方法被调用以取消symbol和side的多个订单。

editPositionBrackets(positionId, focus)

如果supportBrackets配置标志开启显示用于编辑利润和止损的对话框，则调用此方法。

positionId 是要修改的现有位置的ID
focus - [[Focus constant|Trading-Objects-and-Constants#focusoptions]].

closePosition(positionId, silently)

如果supportBrackets配置标志开启显示用于平仓的对话框，则调用此方法。
如果 silently 为true，则不显示任何对话框。

reversePosition(positionId, silently)

如果“supportReversePosition”配置标志打开，则通过id来反转头寸，将调用此方法。
如果 silently 为true，则不显示任何对话框。

symbolInfo(symbol) : Deferred (or Promise)

symbol - 商品字符串

该方法由内部Order Dialog，DOM面板和浮动交易面板调用以获取商品信息。
结果是具有以下数据的对象：
对象具有 min, max and step 指定数量字段步骤和边界的字段“min”，“max”和“step”。

qty - object with fields min, max and step 它指定数量字段的步骤和边界。
pipSize - 大小为1个点数（例如，欧元兑美元0.0001）
pipValue - 帐户货币为1点的价值\（例如，美元兑换EURUSD的1美元）
minTick - 最低价格变动\（例如，EURUSD \ 0.00001）。它用于价格领域。
description - 要在对话框中显示的说明
type - 仪器类型，只有“forex”事项 - 它可以在订单对话框中进行负点检查

accountInfo() : Deferred (or Promise)

内部订单对话框调用此方法获取帐户信息。

现在应该只返回一个字段：
1。currencysign：字符串 - 这是一个帐户币值的符号

subscribePL(positionId)

如果supportPLUpdate 配置标志为true，则应该执行方法。
由于该方法被经纪人调用，通过\ [\ [plUpdate \ | Trading-Host \＃plupdatepositionid-pl ]]方法提供损益。

unsubscribePL(positionId)

如果supportPLUpdate 配置标志为true，则应该执行方法。
由于这种方法被经纪人调用，来停止提供损益。

subscribeEquity()

如果您使用标准订单对话框并支持止损，则应执行方法。
这种方法被经纪人调用，[[equityUpdate|Trading-Host#equityupdateequity]]

unsubscribeEquity()

如果您使用标准订单对话框并支持止损，则应执行方法。
由于这种方法被经纪人导游，停止提供股权更新。

这就是它！

5-2、交易控制器