跳转到内容

请求查询显示组

queryDisplayGroups(reqId) 用来查询 TWS 中可以被 API 控制的显示组。它是显示组功能的第一步:先知道有哪些组,才能订阅或更新其中一个组。

def request_display_groups(app) -> None:
# reqId 是请求编号,displayGroupList() 回调会原样返回。
app.queryDisplayGroups(98601)
参数类型说明
reqId整数请求编号。它不是显示组 ID,只用来对应回调。

这个接口不需要 groupId,因为它的目的就是查询可用组。

如果 displayGroupList() 返回空字符串,通常表示 TWS 没有可用显示组,或没有打开支持显示组联动的窗口。程序不要把空结果当成连接失败;更合适的提示是:

TWS 暂时没有返回可用显示组。请在 TWS 中打开图表、报价或相关联动窗口后重试。
  • 不要写死显示组 ID,例如永远使用 4
  • 每次启动程序都先调用 queryDisplayGroups()
  • 只从 displayGroupList() 返回的字符串里选择有效数字。
  • 查询不到显示组时,禁用后续“订阅”和“更新显示组”按钮或流程。