在 MQL5 中使用 AutoIt
MetaTrader 5
—
示例
| 21 二月 2022, 13:47
1 249
0
概述
在通过 DLL 管理 MetaTrader 终端一文中，作者详细介绍了如何运用自定义动态链接库（DLL）通过程序化控制应用程序的图形用户界面（gui）来管理 MetaTrader 4（MetaTrader 4）。 在本文中，我们将研究类似的内容，但代替编写自定义的 DLL，我们将利用 AutoIt 提供的传动功能。 利用 AutoIt，我们将创建一个类，来实现纯 MQL5 无法完成的自动化任务。
这些任务包括：
- 能够在图表上添加和删除脚本或智能交易系统。
- 在工具箱窗口中读取终端的智能系统和日志选项卡。
- 自动处理警报（读取警报消息和自动关闭警报对话）的能力。
- 最后，我们将实现 MetaTrader 4 文章中演示的相同功能，即在终端设定中设置 MetaQuotes ID 的能力。
AutoIt
AutoIt 是一种用于自动化 Microsoft Windows 图形用户界面的脚本语言。 除提供窗口管理以外，它还能直接访问用户界面组件、以及鼠标和键盘敲击的输入模拟。 AutoIt 的一部分是 AutoItX，它是一个 dll，实现了 AutoIt 脚本语言的一些功能。 通过与这个 dll 交互，我们可以赋予 MQL5 的 gui 类似脚本功能。
安装
AutoIt 软件可从此链接处免费获得。 它可以在 x86 版本的所有 Microsoft Windows 直至 Windows 10 上运行。 它是一个 32 位应用程序，携带多个 64 位组件，也包括 64 位版本的 AutoItX。 如果您希望了解有关 AutoIt 的更多信息，那么阅读应用程序安装一部分的帮助文件是必不可少的。 在我们深入研究之前，我们需要意识到 AutoIt 的局限性。
局限性
AutoIt 的局限性在于，它只能与 Win32 API 提供的标准 Microsoft Windows 组件一起可靠工作。 如果一个程序用到定制的控件，那么它将无法工作。 对于使用跨平台框架创建的软件，这一点基本上确定无疑。 我们可以利用 AutoIt 的窗口信息工具检查程序的用户界面是否能与 AutoIt 兼容。另一个需要注意的限制是，AutoItX 只实现了 AutoIt 脚本语言的部分功能。 一个组件可以由 AutoIt 操控，但相同的功能也许无法经由 AutoItX 操控。
AutoIt 的窗口信息工具
AutoIt 附带一个名为 AutoIt Window Info Tool 的应用程序，用于获取有关应用程序窗口的信息。
拖拽 Finder 工具覆盖到目标应用程序的任何部分，我们就可以获得特定组件的属性。 这些组件被称为控件。 控件可以是按钮、下拉菜单或选项卡。 这些仅是少数几个例子，还有许多类型的控件用于构建应用程序。 每个控件都与一个窗口相关联。 一个应用程序可由多个窗口组成。 通常有一个主窗口，其它子窗口依附或驻靠在主窗口上。 如果子窗口依附或驻靠到主应用程序窗口，则这些子窗口中内含的所有控件均变为主应用程序窗口的一部分。 利用 AutoIt 精确定位到一个控件时，控件关联的窗口很重要，无论是子窗口还是主应用程序窗口。
查看下图，我们可以看到 finder 工具被拖拽到 Metatrader 5（Metatrader 5）应用程序的不同区域。 当选定选项菜单时，请注意窗口信息工具的设置。 冻结、始终在顶部、以及用 Spy++ 控制检测逻辑，几个选项均被勾选。
窗口选项卡的显示聚焦在应用程序窗口的属性，此处列出了窗口的标题和类别。 这些属性可用作它的唯一性标识。 移至控件选项卡，我们可以看到控件的属性，我们感兴趣的是 ClassnameNN 属性。 （注意在 AutoIt 上下文中的类名引用的是控件的类型）。 该属性是把控件类型以及实例标识符的数字形式加以组合。 了解控件的类型非常重要，因为这将决定 AutoIt 调用哪些函数处理它。
AutoItX 集成
为了确保能与 MetaTrader 5 成功集成，我们首先要确保终端在运行时能够找到所需的 dll。 为了实现这一点，我们简单地将所需的 dll 复制到 MetaTrader 5 安装目录的 Libraries 文件夹当中。 默认的 AutoIt3 安装目录位于 Program files (x86) 文件夹之中。 其中的 AutoItX 文件夹包含所有与 AutoItX 相关的组件，也包括 AutoItX3_Dll 头文件，其中列出了 Dll 中公开的所有函数原型。 这些对于您的 MetaTrader 5（64 或 32 位）构建版本获取相应的 dll 非常重要。
#pragma once /////////////////////////////////////////////////////////////////////////////// // // AutoItX v3 // // Copyright (C)1999-2013: // - Jonathan Bennett <jon at autoitscript dot com> // - See "AUTHORS.txt" for contributors. // // This file is part of AutoItX. Use of this file and the AutoItX DLL is subject // to the terms of the AutoItX license details of which can be found in the helpfile. // // When using the AutoItX3.dll as a standard DLL this file contains the definitions, // and function declarations required to use the DLL and AutoItX3_DLL.lib file. // /////////////////////////////////////////////////////////////////////////////// #ifdef __cplusplus #define AU3_API extern "C" #else #define AU3_API #endif // Definitions #define AU3_INTDEFAULT (-2147483647) // "Default" value for _some_ int parameters (largest negative number) // // nBufSize // When used for specifying the size of a resulting string buffer this is the number of CHARACTERS // in that buffer, including the null terminator. For example: // // WCHAR szBuffer[10]; // AU3_ClipGet(szBuffer, 10); // // The resulting string will be truncated at 9 characters with the the terminating null in the 10th. // /////////////////////////////////////////////////////////////////////////////// // Exported functions /////////////////////////////////////////////////////////////////////////////// #include <windows.h> AU3_API void WINAPI AU3_Init(void); AU3_API int AU3_error(void); AU3_API int WINAPI AU3_AutoItSetOption(LPCWSTR szOption, int nValue); AU3_API void WINAPI AU3_ClipGet(LPWSTR szClip, int nBufSize); AU3_API void WINAPI AU3_ClipPut(LPCWSTR szClip); AU3_API int WINAPI AU3_ControlClick(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPCWSTR szButton, int nNumClicks, int nX = AU3_INTDEFAULT, int nY = AU3_INTDEFAULT); AU3_API int WINAPI AU3_ControlClickByHandle(HWND hWnd, HWND hCtrl, LPCWSTR szButton, int nNumClicks, int nX = AU3_INTDEFAULT, int nY = AU3_INTDEFAULT); AU3_API void WINAPI AU3_ControlCommand(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPCWSTR szCommand, LPCWSTR szExtra, LPWSTR szResult, int nBufSize); AU3_API void WINAPI AU3_ControlCommandByHandle(HWND hWnd, HWND hCtrl, LPCWSTR szCommand, LPCWSTR szExtra, LPWSTR szResult, int nBufSize); AU3_API void WINAPI AU3_ControlListView(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPCWSTR szCommand, LPCWSTR szExtra1, LPCWSTR szExtra2, LPWSTR szResult, int nBufSize); AU3_API void WINAPI AU3_ControlListViewByHandle(HWND hWnd, HWND hCtrl, LPCWSTR szCommand, LPCWSTR szExtra1, LPCWSTR szExtra2, LPWSTR szResult, int nBufSize); AU3_API int WINAPI AU3_ControlDisable(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl); AU3_API int WINAPI AU3_ControlDisableByHandle(HWND hWnd, HWND hCtrl); AU3_API int WINAPI AU3_ControlEnable(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl); AU3_API int WINAPI AU3_ControlEnableByHandle(HWND hWnd, HWND hCtrl); AU3_API int WINAPI AU3_ControlFocus(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl); AU3_API int WINAPI AU3_ControlFocusByHandle(HWND hWnd, HWND hCtrl); AU3_API void WINAPI AU3_ControlGetFocus(LPCWSTR szTitle, LPCWSTR szText, LPWSTR szControlWithFocus, int nBufSize); AU3_API void WINAPI AU3_ControlGetFocusByHandle(HWND hWnd, LPWSTR szControlWithFocus, int nBufSize); AU3_API HWND WINAPI AU3_ControlGetHandle(HWND hWnd, LPCWSTR szControl); AU3_API void WINAPI AU3_ControlGetHandleAsText(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPCWSTR szControl, LPWSTR szRetText, int nBufSize); AU3_API int WINAPI AU3_ControlGetPos(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPRECT lpRect); AU3_API int WINAPI AU3_ControlGetPosByHandle(HWND hWnd, HWND hCtrl, LPRECT lpRect); AU3_API void WINAPI AU3_ControlGetText(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPWSTR szControlText, int nBufSize); AU3_API void WINAPI AU3_ControlGetTextByHandle(HWND hWnd, HWND hCtrl, LPWSTR szControlText, int nBufSize); AU3_API int WINAPI AU3_ControlHide(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl); AU3_API int WINAPI AU3_ControlHideByHandle(HWND hWnd, HWND hCtrl); AU3_API int WINAPI AU3_ControlMove(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, int nX, int nY, int nWidth = -1, int nHeight = -1); AU3_API int WINAPI AU3_ControlMoveByHandle(HWND hWnd, HWND hCtrl, int nX, int nY, int nWidth = -1, int nHeight = -1); AU3_API int WINAPI AU3_ControlSend(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPCWSTR szSendText, int nMode = 0); AU3_API int WINAPI AU3_ControlSendByHandle(HWND hWnd, HWND hCtrl, LPCWSTR szSendText, int nMode = 0); AU3_API int WINAPI AU3_ControlSetText(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPCWSTR szControlText); AU3_API int WINAPI AU3_ControlSetTextByHandle(HWND hWnd, HWND hCtrl, LPCWSTR szControlText); AU3_API int WINAPI AU3_ControlShow(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl); AU3_API int WINAPI AU3_ControlShowByHandle(HWND hWnd, HWND hCtrl); AU3_API void WINAPI AU3_ControlTreeView(LPCWSTR szTitle, LPCWSTR szText, LPCWSTR szControl, LPCWSTR szCommand, LPCWSTR szExtra1, LPCWSTR szExtra2, LPWSTR szResult, int nBufSize); AU3_API void WINAPI AU3_ControlTreeViewByHandle(HWND hWnd, HWND hCtrl, LPCWSTR szCommand, LPCWSTR szExtra1, LPCWSTR szExtra2, LPWSTR szResult, int nBufSize); AU3_API void WINAPI AU3_DriveMapAdd(LPCWSTR szDevice, LPCWSTR szShare, int nFlags, /*[in,defaultvalue("")]*/LPCWSTR szUser, /*[in,defaultvalue("")]*/LPCWSTR szPwd, LPWSTR szResult, int nBufSize); AU3_API int WINAPI AU3_DriveMapDel(LPCWSTR szDevice); AU3_API void WINAPI AU3_DriveMapGet(LPCWSTR szDevice, LPWSTR szMapping, int nBufSize); AU3_API int WINAPI AU3_IsAdmin(void); AU3_API int WINAPI AU3_MouseClick(/*[in,defaultvalue("LEFT")]*/LPCWSTR szButton, int nX = AU3_INTDEFAULT, int nY = AU3_INTDEFAULT, int nClicks = 1, int nSpeed = -1); AU3_API int WINAPI AU3_MouseClickDrag(LPCWSTR szButton, int nX1, int nY1, int nX2, int nY2, int nSpeed = -1); AU3_API void WINAPI AU3_MouseDown(/*[in,defaultvalue("LEFT")]*/LPCWSTR szButton); AU3_API int WINAPI AU3_MouseGetCursor(void); AU3_API void WINAPI AU3_MouseGetPos(LPPOINT lpPoint); AU3_API int WINAPI AU3_MouseMove(int nX, int nY, int nSpeed = -1); AU3_API void WINAPI AU3_MouseUp(/*[in,defaultvalue("LEFT")]*/LPCWSTR szButton); AU3_API void WINAPI AU3_MouseWheel(LPCWSTR szDirection, int nClicks); AU3_API int WINAPI AU3_Opt(LPCWSTR szOption, int nValue); AU3_API unsigned int WINAPI AU3_PixelChecksum(LPRECT lpRect, int nStep = 1); AU3_API int WINAPI AU3_PixelGetColor(int nX, int nY); AU3_API void WINAPI AU3_PixelSearch(LPRECT lpRect, int nCol, /*default 0*/int nVar, /*default 1*/int nStep, LPPOINT pPointResult); AU3_API int WINAPI AU3_ProcessClose(LPCWSTR szProcess); AU3_API int WINAPI AU3_ProcessExists(LPCWSTR szProcess); AU3_API int WINAPI AU3_ProcessSetPriority(LPCWSTR szProcess, int nPriority); AU3_API int WINAPI AU3_ProcessWait(LPCWSTR szProcess, int nTimeout = 0); AU3_API int WINAPI AU3_ProcessWaitClose(LPCWSTR szProcess, int nTimeout = 0); AU3_API int WINAPI AU3_Run(LPCWSTR szProgram, /*[in,defaultvalue("")]*/LPCWSTR szDir, int nShowFlag = SW_SHOWNORMAL); AU3_API int WINAPI AU3_RunWait(LPCWSTR szProgram, /*[in,defaultvalue("")]*/LPCWSTR szDir, int nShowFlag = SW_SHOWNORMAL); AU3_API int WINAPI AU3_RunAs(LPCWSTR szUser, LPCWSTR szDomain, LPCWSTR szPassword, int nLogonFlag, LPCWSTR szProgram, /*[in,defaultvalue("")]*/LPCWSTR szDir, int nShowFlag = SW_SHOWNORMAL); AU3_API int WINAPI AU3_RunAsWait(LPCWSTR szUser, LPCWSTR szDomain, LPCWSTR szPassword, int nLogonFlag, LPCWSTR szProgram, /*[in,defaultvalue("")]*/LPCWSTR szDir, int nShowFlag = SW_SHOWNORMAL); AU3_API void WINAPI AU3_Send(LPCWSTR szSendText, int nMode = 0); AU3_API int WINAPI AU3_Shutdown(int nFlags); AU3_API void WINAPI AU3_Sleep(int nMilliseconds); AU3_API int WINAPI AU3_StatusbarGetText(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, /*[in,defaultvalue(1)]*/int nPart, LPWSTR szStatusText, int nBufSize); AU3_API int WINAPI AU3_StatusbarGetTextByHandle(HWND hWnd, /*[in,defaultvalue(1)]*/int nPart, LPWSTR szStatusText, int nBufSize); AU3_API void WINAPI AU3_ToolTip(LPCWSTR szTip, int nX = AU3_INTDEFAULT, int nY = AU3_INTDEFAULT); AU3_API int WINAPI AU3_WinActivate(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API int WINAPI AU3_WinActivateByHandle(HWND hWnd); AU3_API int WINAPI AU3_WinActive(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API int WINAPI AU3_WinActiveByHandle(HWND hWnd); AU3_API int WINAPI AU3_WinClose(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API int WINAPI AU3_WinCloseByHandle(HWND hWnd); AU3_API int WINAPI AU3_WinExists(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API int WINAPI AU3_WinExistsByHandle(HWND hWnd); AU3_API int WINAPI AU3_WinGetCaretPos(LPPOINT lpPoint); AU3_API void WINAPI AU3_WinGetClassList(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPWSTR szRetText, int nBufSize); AU3_API void WINAPI AU3_WinGetClassListByHandle(HWND hWnd, LPWSTR szRetText, int nBufSize); AU3_API int WINAPI AU3_WinGetClientSize(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPRECT lpRect); AU3_API int WINAPI AU3_WinGetClientSizeByHandle(HWND hWnd, LPRECT lpRect); AU3_API HWND WINAPI AU3_WinGetHandle(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API void WINAPI AU3_WinGetHandleAsText(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPWSTR szRetText, int nBufSize); AU3_API int WINAPI AU3_WinGetPos(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPRECT lpRect); AU3_API int WINAPI AU3_WinGetPosByHandle(HWND hWnd, LPRECT lpRect); AU3_API DWORD WINAPI AU3_WinGetProcess(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API DWORD WINAPI AU3_WinGetProcessByHandle(HWND hWnd); AU3_API int WINAPI AU3_WinGetState(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API int WINAPI AU3_WinGetStateByHandle(HWND hWnd); AU3_API void WINAPI AU3_WinGetText(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPWSTR szRetText, int nBufSize); AU3_API void WINAPI AU3_WinGetTextByHandle(HWND hWnd, LPWSTR szRetText, int nBufSize); AU3_API void WINAPI AU3_WinGetTitle(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPWSTR szRetText, int nBufSize); AU3_API void WINAPI AU3_WinGetTitleByHandle(HWND hWnd, LPWSTR szRetText, int nBufSize); AU3_API int WINAPI AU3_WinKill(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText); AU3_API int WINAPI AU3_WinKillByHandle(HWND hWnd); AU3_API int WINAPI AU3_WinMenuSelectItem(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, LPCWSTR szItem1, LPCWSTR szItem2, LPCWSTR szItem3, LPCWSTR szItem4, LPCWSTR szItem5, LPCWSTR szItem6, LPCWSTR szItem7, LPCWSTR szItem8); AU3_API int WINAPI AU3_WinMenuSelectItemByHandle(HWND hWnd, LPCWSTR szItem1, LPCWSTR szItem2, LPCWSTR szItem3, LPCWSTR szItem4, LPCWSTR szItem5, LPCWSTR szItem6, LPCWSTR szItem7, LPCWSTR szItem8); AU3_API void WINAPI AU3_WinMinimizeAll(); AU3_API void WINAPI AU3_WinMinimizeAllUndo(); AU3_API int WINAPI AU3_WinMove(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nX, int nY, int nWidth = -1, int nHeight = -1); AU3_API int WINAPI AU3_WinMoveByHandle(HWND hWnd, int nX, int nY, int nWidth = -1, int nHeight = -1); AU3_API int WINAPI AU3_WinSetOnTop(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nFlag); AU3_API int WINAPI AU3_WinSetOnTopByHandle(HWND hWnd, int nFlag); AU3_API int WINAPI AU3_WinSetState(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nFlags); AU3_API int WINAPI AU3_WinSetStateByHandle(HWND hWnd, int nFlags); AU3_API int WINAPI AU3_WinSetTitle(LPCWSTR szTitle,/*[in,defaultvalue("")]*/ LPCWSTR szText, LPCWSTR szNewTitle); AU3_API int WINAPI AU3_WinSetTitleByHandle(HWND hWnd, LPCWSTR szNewTitle); AU3_API int WINAPI AU3_WinSetTrans(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nTrans); AU3_API int WINAPI AU3_WinSetTransByHandle(HWND hWnd, int nTrans); AU3_API int WINAPI AU3_WinWait(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nTimeout = 0); AU3_API int WINAPI AU3_WinWaitByHandle(HWND hWnd, int nTimeout); AU3_API int WINAPI AU3_WinWaitActive(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nTimeout = 0); AU3_API int WINAPI AU3_WinWaitActiveByHandle(HWND hWnd, int nTimeout); AU3_API int WINAPI AU3_WinWaitClose(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nTimeout = 0); AU3_API int WINAPI AU3_WinWaitCloseByHandle(HWND hWnd, int nTimeout); AU3_API int WINAPI AU3_WinWaitNotActive(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText, int nTimeout); AU3_API int WINAPI AU3_WinWaitNotActiveByHandle(HWND hWnd, int nTimeout = 0); ///////////////////////////////////////////////////////////////////////////////
任何用到 AutoItX 链接库的 MetaTrader 5 程序都必须首先导入其函数。 为方便起见，我们将创建一个包含文件 autoIt.mqh，其唯一目的是导入链接库公开的所有函数原型。
AutoIt 严格来说是一款运行在 Microsoft Windows 操作系统上的 Windows API 传动工具。 这就是 AuotItX 链接库广泛采用 Win32 API 特定数据类型的原因。 为了确保与 MQL5 的兼容性，我们可以自己在 MQL5 中实现这些数据类型，但这并非必需。 取而代之，我们可以利用 windef.mqh 文件，它是 MetaQuotes 在 MQL5 中集成 Win32 API 的一部分工作成效。 该文件包含 Windows api 中用到的大多数数据类型定义。
我们将在 autoit.mqh 文件中包含 windef.mqh，其内包含从 dll 导入的所有函数原型。 autoit.mqh 代码文件现在看起来如下所示：
//+------------------------------------------------------------------+ //| autoIt.mqh | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #include <WinAPI\windef.mqh> #define LPPOINT POINT& #define LPRECT RECT& #define WORD ushort #define DWORD int #define HWND int #import "AutoItX3_x64.dll" void AU3_Init(void); int AU3_error(void); int AU3_AutoItSetOption(string, int); void AU3_ClipGet(string&, int); void AU3_ClipPut(string); int AU3_ControlClick(string, string, string, string, int, int, int); int AU3_ControlClickByHandle(HWND, HWND, string, int, int, int); void AU3_ControlCommand(string, string, string, string, string, string&, int); void AU3_ControlCommandByHandle(HWND, HWND, string, string, string&, int); void AU3_ControlListView(string, string, string, string, string, string, string&, int); void AU3_ControlListViewByHandle(HWND, HWND, string, string, string, string&, int); int AU3_ControlDisable(string, string, string); int AU3_ControlDisableByHandle(HWND, HWND); int AU3_ControlEnable(string, string, string); int AU3_ControlEnableByHandle(HWND, HWND); int AU3_ControlFocus(string, string, string); int AU3_ControlFocusByHandle(HWND, HWND); void AU3_ControlGetFocus(string, string, string&, int); void AU3_ControlGetFocusByHandle(HWND, string&, int); HWND AU3_ControlGetHandle(HWND, string); void AU3_ControlGetHandleAsText(string, string, string, string&, int); int AU3_ControlGetPos(string, string, string, LPRECT); int AU3_ControlGetPosByHandle(HWND, HWND, LPRECT); void AU3_ControlGetText(string, string, string, string&, int); void AU3_ControlGetTextByHandle(HWND, HWND, string&, int); int AU3_ControlHide(string, string, string); int AU3_ControlHideByHandle(HWND, HWND); int AU3_ControlMove(string, string, string, int, int, int, int); int AU3_ControlMoveByHandle(HWND, HWND, int, int, int, int); int AU3_ControlSend(string, string, string, string, int); int AU3_ControlSendByHandle(HWND, HWND, string, int); int AU3_ControlSetText(string, string, string, string); int AU3_ControlSetTextByHandle(HWND, HWND, string); int AU3_ControlShow(string, string, string); int AU3_ControlShowByHandle(HWND, HWND); void AU3_ControlTreeView(string, string, string, string, string, string, string&, int); void AU3_ControlTreeViewByHandle(HWND, HWND, string, string, string, string&, int); void AU3_DriveMapAdd(string, string, int, string, string, string&, int); int AU3_DriveMapDel(string); void AU3_DriveMapGet(string, string&, int); int AU3_IsAdmin(void); int AU3_MouseClick(string, int, int, int, int); int AU3_MouseClickDrag(string, int, int, int, int, int); void AU3_MouseDown(string); int AU3_MouseGetCursor(void); void AU3_MouseGetPos(LPPOINT); int AU3_MouseMove(int, int, int); void AU3_MouseUp(string); void AU3_MouseWheel(string, int); int AU3_Opt(string, int); unsigned int AU3_PixelChecksum(LPRECT, int); int AU3_PixelGetColor(int, int); void AU3_PixelSearch(LPRECT, int, int, int, LPPOINT); int AU3_ProcessClose(string); int AU3_ProcessExists(string); int AU3_ProcessSetPriority(string, int); int AU3_ProcessWait(string, int); int AU3_ProcessWaitClose(string, int); int AU3_Run(string, string, int); int AU3_RunWait(string, string, int); int AU3_RunAs(string, string, string, int, string, string, int); int AU3_RunAsWait(string, string, string, int, string, string, int); void AU3_Send(string, int); int AU3_Shutdown(int); void AU3_Sleep(int); int AU3_StatusbarGetText(string, string, int, string&, int); int AU3_StatusbarGetTextByHandle(HWND, int, string&, int); void AU3_ToolTip(string, int, int); int AU3_WinActivate(string, string); int AU3_WinActivateByHandle(HWND); int AU3_WinActive(string, string); int AU3_WinActiveByHandle(HWND); int AU3_WinClose(string, string); int AU3_WinCloseByHandle(HWND); int AU3_WinExists(string, string); int AU3_WinExistsByHandle(HWND); int AU3_WinGetCaretPos(LPPOINT); void AU3_WinGetClassList(string, string, string&, int); void AU3_WinGetClassListByHandle(HWND, string&, int); int AU3_WinGetClientSize(string, string, LPRECT); int AU3_WinGetClientSizeByHandle(HWND, LPRECT); HWND AU3_WinGetHandle(string, string); void AU3_WinGetHandleAsText(string, string, string&, int); int AU3_WinGetPos(string, string, LPRECT); int AU3_WinGetPosByHandle(HWND, LPRECT); DWORD AU3_WinGetProcess(string, string); DWORD AU3_WinGetProcessByHandle(HWND); int AU3_WinGetState(string, string); int AU3_WinGetStateByHandle(HWND); void AU3_WinGetText(string, string, string&, int); void AU3_WinGetTextByHandle(HWND, string&, int); void AU3_WinGetTitle(string, string, string&, int); void AU3_WinGetTitleByHandle(HWND, string&, int); int AU3_WinKill(string, string); int AU3_WinKillByHandle(HWND); int AU3_WinMenuSelectItem(string, string, string, string, string, string, string, string, string, string); int AU3_WinMenuSelectItemByHandle(HWND, string, string, string, string, string, string, string, string); void AU3_WinMinimizeAll(); void AU3_WinMinimizeAllUndo(); int AU3_WinMove(string, string, int, int, int, int); int AU3_WinMoveByHandle(HWND, int, int, int, int); int AU3_WinSetOnTop(string, string, int); int AU3_WinSetOnTopByHandle(HWND, int); int AU3_WinSetState(string, string, int); int AU3_WinSetStateByHandle(HWND, int); int AU3_WinSetTitle(string, string, string); int AU3_WinSetTitleByHandle(HWND, string); int AU3_WinSetTrans(string, string, int); int AU3_WinSetTransByHandle(HWND, int); int AU3_WinWait(string, string, int); int AU3_WinWaitByHandle(HWND, int); int AU3_WinWaitActive(string, string, int); int AU3_WinWaitActiveByHandle(HWND, int); int AU3_WinWaitClose(string, string, int); int AU3_WinWaitCloseByHandle(HWND, int); int AU3_WinWaitNotActive(string, string, int); int AU3_WinWaitNotActiveByHandle(HWND, int); #import //+------------------------------------------------------------------+
用法初备
在 MQL5 中使用链接库首先需要调用 AU3_Init 函数初始化 dll。 这一步应该在调用任何其它导入函数之前完成。 函数原型签名类似于 AutoIt 脚本语言中用到的签名，这意味着它们具有相似的函数参数和返回类型。 为了理解这些函数是如何工作的，必须熟悉 AutoIt 脚本语言，所有这些信息都可以在应用程序安装的帮助文件中找到。
一个初始化示例
以下示例演示了在 MQL5 中调用 AutoItX 函数。 在下面的脚本中，我们将调用 AU3_wingthandle 函数获取终端主窗口的句柄。 终端可依据窗口标题栏中显示的活动帐号进行唯一性识别。
//+------------------------------------------------------------------+ //| TerminalUIComponents.mq5 | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #property version "1.00" #include<autoIt.mqh> string sbuffer; //+------------------------------------------------------------------+ //| Script program start function | //+------------------------------------------------------------------+ void OnStart() { //--- AU3_Init();//initialize the library if(!StringInit(sbuffer,1000))// set buffer length for string Print("Failed to set string bufferlength with error - "+string(GetLastError())); HWND window_handle=AU3_WinGetHandle(IntegerToString(AccountInfoInteger(ACCOUNT_LOGIN)),"");// get the terminal's handle if(!window_handle) Print("Could not find main app window. Error is "+string(AU3_error())); AU3_WinGetClassListByHandle(window_handle,sbuffer,1000);// get classnames of all user interface componets of the terminal Print(sbuffer); } //+------------------------------------------------------------------+
检索主窗口句柄，我们可以调用 AU3_wingtclassistbyhandle 函数来获取更多有关 gui 组件的信息。 它将返回一个字符串列表，这些字符串包含与所提供窗口句柄关联的所有用户界面组件的类名。
运行脚本后的结果如下所示
在我们继续讨论一些更健壮的示例之前，我们创建一个类来封装大多数导入的 AutoIt 函数。
CAutoit 类
CAutoit 将作为基类，其它调用 AutoItX 链接库的类将从其中派生。 它将拥有一个静态属性，指定是否调用了初始化库函数 AU3_Init()。
另一个属性 m_buffer_size 保存方法调用时检测的字符串缓冲区长度。
//+------------------------------------------------------------------+ //| autoitbase.mqh | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #include<autoIt.mqh> enum ENUM_WINDOW_STATE { SW_HIDE=0, SW_SHOW, SW_MINIMIZE, SW_MAXIMIZE, SW_RESTORE }; //+------------------------------------------------------------------+ //| Class CAutoIt. | //| Purpose: class for working with autoit. | //+------------------------------------------------------------------+ class CAutoIt { private: int m_buffer_size; //string buffer size // --- static property common to all object instances static bool m_initialized; //flag for checking initialization state //--- private methods void ResetBuffer(string &buffer) { StringFill(buffer,0); } public: //--- constructor, destructor CAutoIt(void); ~CAutoIt(void); void Init(void); //--- static method static bool IsInitialized(void) { return(m_initialized); } //--- general purpose methods int Error(void) { return (AU3_error()); } void Sleep(const int milliseconds) { AU3_Sleep(milliseconds); } void SetBufferLen(const int n_bufferlen) { m_buffer_size=(n_bufferlen>0)?n_bufferlen:1000; } int GetBufferLen(void) { return(m_buffer_size); } protected: int Run(const string exefile,const string path,const ENUM_WINDOW_STATE w_state) { return(AU3_Run(exefile,path,int(w_state))); } //--- system clipboard manipulation void ClipGet(string & out); void ClipPut(string copy); //--- void ControlPosition(HWND window_handle,HWND control_handle, LPRECT rect) { AU3_ControlGetPosByHandle(window_handle,control_handle, rect);} //--- methods for simulating clicks int ControlRightClick(HWND window_handle, HWND control_handle,int number_of_clicks=1,int x=1,int y=1); int ControlLeftClick(HWND window_handle, HWND control_handle,int number_of_clicks=1,int x=1,int y=1); //--- general Control Command method bool ControlCommand(HWND window_handle, HWND control_handle, string command, string command_option); //--- methods for interacting with comboboxes, buttons,radio buttons string GetCurrentComboBoxSelection(HWND window_handle, HWND control_handle); bool IsControlEnabled(HWND window_handle, HWND control_handle); bool IsControlVisible(HWND window_handle, HWND control_handle); int EnableControl(HWND window_handle, HWND control_handle) { return(AU3_ControlEnableByHandle(window_handle,control_handle));} int ShowControl(HWND window_handle, HWND control_handle) { return(AU3_ControlShowByHandle(window_handle,control_handle)); } int ControlFocus(HWND window_handle,HWND control_handle) { return(AU3_ControlFocusByHandle(window_handle,control_handle)); } bool IsButtonChecked(HWND window_handle, HWND control_handle); bool CheckButton(HWND window_handle, HWND control_handle); bool UnCheckButton(HWND window_handle, HWND control_handle); //--- methods for interacting with system32tab control string GetCurrentTab(HWND window_handle, HWND control_handle); bool TabRight(HWND window_handle, HWND control_handle); bool TabLeft(HWND window_handle, HWND control_handle); long TotalTabs(HWND window, HWND systab); //--- methods for interacting with syslistview32 control bool ControlListView(HWND window_handle, HWND control_handle, string command, string command_option1, string command_option2); long GetListViewItemCount(HWND window_handle, HWND control_handle); long FindListViewItem(HWND window_handle, HWND control_handle, string find_item,string sub_item); string GetSelectedListViewItem(HWND window_handle, HWND control_handle); long GetSelectedListViewCount(HWND window_handle, HWND control_handle); long GetListViewSubItemCount(HWND window_handle, HWND control_handle); string GetListViewItemText(HWND window_handle, HWND control_handle,string item_index,string sub_item_index); bool IsListViewItemSelected(HWND window_handle, HWND control_handle, string item_index); bool SelectListViewItem(HWND window_handle, HWND control_handle, string from_item_index,string to_item_index); bool SelectAllListViewItems(HWND window_handle, HWND control_handle); bool ClearAllListViewItemSelections(HWND window_handle, HWND control_handle); bool ViewChangeListView(HWND window_handle, HWND control_handle); //--- general methods for various types of controls HWND ControlGetHandle(HWND window_handle, string control_id); string ControlGetText(HWND window_handle, HWND control_handle); int ControlSetText(HWND window_handle,HWND control_handle,string keys) { return(AU3_ControlSetTextByHandle(window_handle,control_handle,keys));} int ControlSend(HWND window_handle, HWND control_handle, string keys, int mode); bool SetFocus(HWND window_handle,HWND control_handle) { return(AU3_ControlFocusByHandle(window_handle,control_handle)>0); } //--- methods for interacting with systreeview32 control bool ControlTreeView(HWND window_handle, HWND control_handle, string command, string command_option1, string command_option2); long GetTreeViewItemCount(HWND window_handle, HWND control_handle, string item); string GetSelectedTreeViewItem(HWND window_handle, HWND control_handle); string GetTreeViewItemText(HWND window_handle, HWND control_handle,string item); bool SelectTreeViewItem(HWND window_handle, HWND control_handle,string item); //--- general methods for application windows, subwindows and dialogues int WinClose(string window_title, string window_text) { return(AU3_WinClose(window_title,window_text)); } int WinClose(HWND window_handle) { return(AU3_WinCloseByHandle(window_handle)); } string WinGetText(HWND window_handle); int WinMenuSelectItem(HWND window_handle, string menu_name_1, string menu_name_2, string menu_name_3, string menu_name_4, string menu_name_5, string menu_name_6, string menu_name_7, string menu_name_8); int WinSetState(HWND window_handle, ENUM_WINDOW_STATE new_state); string WinGetTitle(HWND window_handle); ENUM_WINDOW_STATE WinGetState(HWND window_handle) { return((ENUM_WINDOW_STATE)AU3_WinGetStateByHandle(window_handle)); } HWND WinGetHandle(string window_title, string window_text); void WinGetPosition(HWND window_handle, LPRECT winpos) { AU3_WinGetPosByHandle(window_handle,winpos); } void WinClientSize(HWND window_handle, LPRECT winsize) { AU3_WinGetClientSizeByHandle(window_handle,winsize); } int WinExists(HWND window_handle) { return(AU3_WinExistsByHandle(window_handle)); } int WinExists(string window_title, string window_text) { return(AU3_WinExists(window_title,window_text)); } }; bool CAutoIt::m_initialized=false; //+------------------------------------------------------------------+ //| Constructor without parameters | //+------------------------------------------------------------------+ CAutoIt::CAutoIt(void): m_buffer_size(1000) { } //+------------------------------------------------------------------+ //| Destructor | //+------------------------------------------------------------------+ CAutoIt::~CAutoIt(void) { } //+------------------------------------------------------------------+ //|Initializes AutoIt library | //+------------------------------------------------------------------+ void CAutoIt::Init(void) { if(!m_initialized) { AU3_Init(); m_initialized=true; } } //+------------------------------------------------------------------+ //|Reads and outputs textual contents of system clipboard | //+------------------------------------------------------------------+ void CAutoIt::ClipGet(string &out) { if(StringBufferLen(out)<m_buffer_size) StringInit(out,m_buffer_size); ResetBuffer(out); AU3_ClipGet(out,m_buffer_size); } //+------------------------------------------------------------------+ //|Writes text to system clipboard | //+------------------------------------------------------------------+ void CAutoIt::ClipPut(string copy) { AU3_ClipPut(copy); } //+------------------------------------------------------------------+ //|Simulates a left click | //+------------------------------------------------------------------+ int CAutoIt::ControlLeftClick(int window_handle,int control_handle,int number_of_clicks=1,int x=1,int y=1) { return(AU3_ControlClickByHandle(window_handle,control_handle,"left",number_of_clicks,x,y)); } //+------------------------------------------------------------------+ //|Simulates a right click | //+------------------------------------------------------------------+ int CAutoIt::ControlRightClick(int window_handle,int control_handle,int number_of_clicks=1,int x=1,int y=1) { return(AU3_ControlClickByHandle(window_handle,control_handle,"right",number_of_clicks,x,y)); } //+------------------------------------------------------------------+ //|Sends a command to a control | //+------------------------------------------------------------------+ bool CAutoIt::ControlCommand(int window_handle,int control_handle,string command,string command_option) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlCommandByHandle(window_handle,control_handle,command,command_option,m_buffer,m_buffer_size); if(StringFind(m_buffer,"0")>=0) return(false); return(true); } //+------------------------------------------------------------------+ //|Retrieves text of currently selected option of a Combobox Control | //+------------------------------------------------------------------+ string CAutoIt::GetCurrentComboBoxSelection(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlCommandByHandle(window_handle,control_handle,"GetCurrentSelection","",m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|Checks if a button is clickable | //+------------------------------------------------------------------+ bool CAutoIt::IsControlEnabled(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"IsEnabled","")); } //+------------------------------------------------------------------+ //|Checks if a control is visible | //+------------------------------------------------------------------+ bool CAutoIt::IsControlVisible(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"IsVisible","")); } //+------------------------------------------------------------------+ //|Checks if tickbox is ticked | //+------------------------------------------------------------------+ bool CAutoIt::IsButtonChecked(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"IsChecked","")); } //+------------------------------------------------------------------+ //| Ticks a tick box | //+------------------------------------------------------------------+ bool CAutoIt::CheckButton(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"Check","")); } //+------------------------------------------------------------------+ //|Unticks a tick box | //+------------------------------------------------------------------+ bool CAutoIt::UnCheckButton(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"UnCheck","")); } //+------------------------------------------------------------------+ //|Gets text of currently enabled tab of SysTabControl32 control | //+------------------------------------------------------------------+ string CAutoIt::GetCurrentTab(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlCommandByHandle(window_handle,control_handle,"CurrentTab","",m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|Enables the tab to the left in SysTabControl32 control | //+------------------------------------------------------------------+ bool CAutoIt::TabLeft(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"TabLeft","")); } //+------------------------------------------------------------------+ //|Enables the tab to the right in SysTabControl32 control | //+------------------------------------------------------------------+ bool CAutoIt::TabRight(int window_handle,int control_handle) { return(ControlCommand(window_handle,control_handle,"TabRight","")); } //+------------------------------------------------------------------+ //|Sends a command to a ListView32 control | //+------------------------------------------------------------------+ bool CAutoIt::ControlListView(int window_handle,int control_handle,string command,string command_option1,string command_option2) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,command,command_option1,command_option2,m_buffer,m_buffer_size); if(StringFind(m_buffer,"1")>=0) return(true); return(false); } //+------------------------------------------------------------------+ //|Gets number of items in ListView32 control | //+------------------------------------------------------------------+ long CAutoIt::GetListViewItemCount(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"GetItemCount","","",m_buffer,m_buffer_size); return(StringToInteger(m_buffer)); } //+-------------------------------------------------------------------------------------------+ //|retrievs the index of a ListView32 control item that matches find_item and sub_item strings| //+-------------------------------------------------------------------------------------------+ long CAutoIt::FindListViewItem(int window_handle,int control_handle,string find_item,string sub_item) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"FindItem",find_item,sub_item,m_buffer,m_buffer_size); return(StringToInteger(m_buffer)); } //+------------------------------------------------------------------+ //|gets the string list of all selected ListView32 control items | //+------------------------------------------------------------------+ string CAutoIt::GetSelectedListViewItem(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"GetSelected","1","",m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|returns number of currently selected ListView32 control items | //+------------------------------------------------------------------+ long CAutoIt::GetSelectedListViewCount(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"GetSelectedCount","","",m_buffer,m_buffer_size); return(StringToInteger(m_buffer)); } //+------------------------------------------------------------------+ //|gets number of sub items in ListView32 control | //+------------------------------------------------------------------+ long CAutoIt::GetListViewSubItemCount(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"GetSubItemCount","","",m_buffer,m_buffer_size); return(StringToInteger(m_buffer)); } //+---------------------------------------------------------------------+ //|returns text of single ListView32 control item referenced by an index| //+---------------------------------------------------------------------+ string CAutoIt::GetListViewItemText(int window_handle,int control_handle,string item_index,string sub_item_index) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"GetText",item_index,sub_item_index,m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|Checks if a certain ListView32 control item is selected | //+------------------------------------------------------------------+ bool CAutoIt::IsListViewItemSelected(int window_handle,int control_handle,string item_index) { return(ControlListView(window_handle,control_handle,"IsSelected",item_index,"")); } //+------------------------------------------------------------------+ //|Selects a certain ListView32 control | //+------------------------------------------------------------------+ bool CAutoIt::SelectListViewItem(int window_handle,int control_handle,string from_item_index,string to_item_index) { return(ControlListView(window_handle,control_handle,"Select",from_item_index,to_item_index)); } //+------------------------------------------------------------------+ //|selects all listview items | //+------------------------------------------------------------------+ bool CAutoIt::SelectAllListViewItems(int window_handle,int control_handle) { return(ControlListView(window_handle,control_handle,"SelectAll","","")); } //+------------------------------------------------------------------+ //|Deselects all currently selected item in a ListView32 control | //+------------------------------------------------------------------+ bool CAutoIt::ClearAllListViewItemSelections(int window_handle,int control_handle) { return(ControlListView(window_handle,control_handle,"SelectClear","","")); } //+------------------------------------------------------------------+ //| Change listview control view to details mode | //+------------------------------------------------------------------+ bool CAutoIt::ViewChangeListView(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlListViewByHandle(window_handle,control_handle,"ViewChange","list","",m_buffer,m_buffer_size); if(StringFind(m_buffer,"1")>=0) return(true); return(false); } //+------------------------------------------------------------------+ //|returns handle for a control | //+------------------------------------------------------------------+ HWND CAutoIt::ControlGetHandle(int window_handle,string control_id) { return(AU3_ControlGetHandle(window_handle,control_id)); } //+------------------------------------------------------------------+ //|returns visible text from a control | //+------------------------------------------------------------------+ string CAutoIt::ControlGetText(int window_handle,int control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlGetTextByHandle(window_handle,control_handle,m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|directs keyboard presses to a certain control | //+------------------------------------------------------------------+ int CAutoIt::ControlSend(int window_handle,int control_handle,string keys,int mode) { return(AU3_ControlSendByHandle(window_handle,control_handle,keys,mode)); } //+------------------------------------------------------------------+ //|Sends a command to a TreeView32 control | //+------------------------------------------------------------------+ bool CAutoIt::ControlTreeView(int window_handle,int control_handle,string command,string command_option1,string command_option2) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlTreeViewByHandle(window_handle,control_handle,command,command_option1,command_option2,m_buffer,m_buffer_size); if(StringFind(m_buffer,"1")>=0) return(true); return(false); } //+-----------------------------------------------------------------------------+ //|returns number of children on a a TreeView32 control item with selected index| //+-----------------------------------------------------------------------------+ long CAutoIt::GetTreeViewItemCount(HWND window_handle, HWND control_handle, string item_index) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlTreeViewByHandle(window_handle,control_handle,"GetItemCount",item_index,"",m_buffer,m_buffer_size); return(StringToInteger(m_buffer)); } //+------------------------------------------------------------------+ //|gets index in string format of selected TreeView32 control item | //+------------------------------------------------------------------+ string CAutoIt::GetSelectedTreeViewItem(HWND window_handle, HWND control_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlTreeViewByHandle(window_handle,control_handle,"GetSelected","","",m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|retrieves the text of a a TreeView32 control item | //+------------------------------------------------------------------+ string CAutoIt::GetTreeViewItemText(HWND window_handle, HWND control_handle,string item) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_ControlTreeViewByHandle(window_handle,control_handle,"GetText",item,"",m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|selects a a TreeView32 control item | //+------------------------------------------------------------------+ bool CAutoIt::SelectTreeViewItem(HWND window_handle, HWND control_handle,string item) { return(ControlTreeView(window_handle,control_handle,"Select",item,"")); } //+------------------------------------------------------------------+ //|returns handle of window by its window title | //+------------------------------------------------------------------+ HWND CAutoIt::WinGetHandle(string window_title, string window_text="") { return(AU3_WinGetHandle(window_title,window_text)); } //+------------------------------------------------------------------+ //|return all text that is visible within a window | //+------------------------------------------------------------------+ string CAutoIt::WinGetText(HWND window_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_WinGetTextByHandle(window_handle,m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|Invokes a menu item of a window | //+------------------------------------------------------------------+ int CAutoIt::WinMenuSelectItem(HWND window_handle, string menu_name_1, string menu_name_2, string menu_name_3, string menu_name_4, string menu_name_5, string menu_name_6, string menu_name_7, string menu_name_8) { return(AU3_WinMenuSelectItemByHandle(window_handle,menu_name_1,menu_name_2,menu_name_3,menu_name_4,menu_name_5,menu_name_6,menu_name_7,menu_name_8)); } //+------------------------------------------------------------------+ //|Shows, hides, minimizes, maximizes, or restores a window | //+------------------------------------------------------------------+ int CAutoIt::WinSetState(HWND window_handle, ENUM_WINDOW_STATE new_state) { return(AU3_WinSetStateByHandle(window_handle,(int)new_state)); } //+------------------------------------------------------------------+ //|retrieves window title | //+------------------------------------------------------------------+ string CAutoIt::WinGetTitle(int window_handle) { string m_buffer; StringInit(m_buffer,m_buffer_size); AU3_WinGetTitleByHandle(window_handle,m_buffer,m_buffer_size); return(m_buffer); } //+------------------------------------------------------------------+ //|Gets total number of tabs in systab32 control | //+------------------------------------------------------------------+ long CAutoIt::TotalTabs(const int window,const int systab) { if(!WinExists(window)) { return(0); } string index=GetCurrentTab(window,systab); long shift=-1; while(TabRight(window,systab)) { index=""; index=GetCurrentTab(window,systab); } shift=StringToInteger(index); return(shift); } //+------------------------------------------------------------------+
CTerminalController 类
接下来，我们在 terminalcontroller.mqh 文件中创建 CTerminalController 类。
首先我们包含 autoitbase.mqh 文件，其内包含 CAutoIt 类。 我们使用预处理指令定义字符串常量，这些常量标识了用户界面组件将要操控的类。
在指定类之前，我们声明了一个自定义枚举，它可把 MetaTrader 5 程序分类为脚本或智能交易系统。
//+------------------------------------------------------------------+ //| terminalcontroller.mqh | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #include<autoItbase.mqh> #define JOURNAL_TAB "SysListView321" #define EXPERTS_TAB "SysListView327" #define NAVIGATOR "SysTreeView321" #define NAVIGATOR_TAB_BAR "AfxWnd140su3" #define PROGRAM_WINDOW_TAB "SysTabControl321" #define EXPERTS_WINDOW_LISTVIEW "SysListView321" #define EXPERTS_REMOVE_BUTTON "Button2" #define DLLCHECK_BUTTON "Button1" #define ALGOTRADECHECK_BUTTON "Button4" #define OK_BUTTON_1 "Button7" #define OK_BUTTON_2 "Button3" #define OK_BUTTON_3 "Button5" #define LOAD_BUTTON "Button1" #define YES_BUTTON "Button1" #define FILENAME_EDIT "Edit1" #define OPTWINDOW_TAB "SysTabControl321" #define OPTWINDOW_CHECK_1 "Button1" #define OPTWINDOW_CHECK_2 "Button2" #define OPTWINDOW_CHECK_3 "Button6" #define OPTWINDOW_OK "Button7" #define OPTWINDOW_EDIT "Edit1" #define EXPERTS_WINDOW "Experts" #define NAVIGATORWINDOW "Navigator" #define TOOLBOXWINDOW "Toolbox" #define FILEDIALOGE_WINDOW "Open" #define WINDOWTEXT_DLL "Allow DLL" #define WINDOWTEXT_EA "Expert Advisor settings" #define WINDOWTEXT_INPUT "Input" #define OPTWINDOW "Options" #define NOTIFICATIONS_TEXT "Enable Push notifications" #define ALERTWINDOW "Alert" #define MENU_TOOLS "&Tools" #define MENU_OPTIONS "&Options" #define MENU_WINDOW "&Window" #define MENU_TILEWINDOWS "&Tile Windows" #define MENU_VIEW "&View" #define MENU_NAVIGATOR "&Navigator" #define MENU_CHARTS "&Charts" #define MENU_EXPERTS_LIST "&Expert List" enum ENUM_TYPE_PROGRAM { ENUM_TYPE_EXPERT=0,//EXPERT_ADVISOR ENUM_TYPE_SCRIPT//SCRIPT };
HWND 类型的私密属性是类中用到的窗口和控件句柄。
//+------------------------------------------------------------------+ //|Class CTerminalController | //| Purpose: class for scripting the terminal | //+------------------------------------------------------------------+ class CTerminalController:public CAutoIt { private: HWND m_terminal; //terminal window handle HWND m_journaltab; //journal tab handle HWND m_expertstab; //experts tab handle HWND m_navigator; //navigator systreeview HWND m_navigatortabs; //navigator tab header HWND m_navigatorwindow; //navigator window HWND m_systab32; //handle to inputs tabbed control with in inputs dialogue HWND m_program; //window handle for user inputs dialogue HWND m_expwindow; //handle to window showing list of experts HWND m_explistview; //list view control for experts list in m_expwindow long m_chartid; //chart id long m_accountNum; //account number string m_buffer; //string buffer
m_chartid 指向调用 MQL5 函数 chartid() 定义的图表标识符。
m_accountNum 是显示在终端应用程序标题栏上的活动帐号。 该值将用于区分终端的活动窗口和其它窗口。
m_buffer 字符串是当出错时填写详细错误消息的地方。
public: //default constructor CTerminalController(void): m_terminal(0), m_journaltab(0), m_expertstab(0), m_navigator(0), m_navigatortabs(0), m_navigatorwindow(0), m_systab32(0), m_program(0), m_expwindow(0), m_explistview(0), m_chartid(-1), m_buffer("") { m_accountNum=AccountInfoInteger(ACCOUNT_LOGIN); StringInit(m_buffer,1000); } //destructor ~CTerminalController(void) { }
CcterMinalController 将有一个单例构造函数。 默认构造函数调用 AccountInfoInteger 函数，返回当前活动终端帐户，并初始化 m_accountNum。
The methods
//public methods string GetErrorDetails(void) { return(m_buffer); } bool ChartExpertAdd(const ENUM_TYPE_PROGRAM p_type,const string ea_name,const string ea_relative_path,const string ea_set_file,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf); bool ChartExpertRemove(const string ea_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf); bool ChartExpertRemoveAll(void); void CloseAlertDialogue(void); void GetLastExpertsLogEntry(string &entry); void GetLastExpertsLogEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry); void GetLastJournalEntry(string &entry); void GetLastJournalEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry); bool Initialize(const long accountNumber=0); bool SwitchToNewChart(string n_symbol, const ENUM_TIMEFRAMES n_tf); bool SetNotificationId(const string MetaQuotes_id); bool ToggleAutoTrading(void); private: //helper methods void SetErrorDetails(const string text); void Findbranch(const long childrenOnBranch,const string index,const string pname,string& sbuffer); bool Findprogram(const ENUM_TYPE_PROGRAM pr_type, const string program_name,const string relative_path,string& sbuffer); string PeriodToString(const ENUM_TIMEFRAMES chart_tf); bool RemoveExpert(const string program_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf); string BrokerName(void); };
若要提取检索错误消息，有有一个 GetErrorDetails()。 该函数返回私密成员 m_buffer 的值。 另一方面，SetErrorDetails() 是一个私密方法，在内部设置 m_buffer 字符串成员的内容。
//+------------------------------------------------------------------+ //| Set error details | //+------------------------------------------------------------------+ void CTerminalController::SetErrorDetails(const string _text) { StringFill(m_buffer,0); m_buffer=_text; return; }
在程序初始化时，先于调用任何其它方法之前，至少调用一次 Initialize() 方法。 该方法只有一个默认参数 accountNumber — 如果该参数非零，它将重置 m_accountNum 类属性的值，该值反过来重置所有其它的类属性，并触发搜索由 m_accountNum 属性标识的主终端窗口。 一旦找到主窗口后，将提取所有其它控件的句柄，并设置其余的类属性。
//+------------------------------------------------------------------+ //| sets or resets window and control handles used in the class | //+------------------------------------------------------------------+ bool CTerminalController::Initialize(const long accountNumber=0) { Init(); if(accountNumber>0 && accountNumber!=m_accountNum) { m_accountNum=accountNumber; m_program=m_expwindow=m_systab32=m_explistview=m_navigatorwindow=0; m_terminal=m_journaltab=m_expertstab=m_navigator=m_navigatortabs=0; m_chartid=0; } if(m_terminal) return(true); m_terminal=WinGetHandle(IntegerToString(m_accountNum)); if(!m_terminal) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Terminal window "+IntegerToString(m_accountNum)+" not found"); return(false); } m_journaltab=ControlGetHandle(m_terminal,JOURNAL_TAB); if(!m_journaltab) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+JOURNAL_TAB+" not found"); return(false); } m_expertstab=ControlGetHandle(m_terminal,EXPERTS_TAB); if(!m_expertstab) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_TAB+" not found"); return(false); } m_navigatorwindow=ControlGetHandle(m_terminal,NAVIGATORWINDOW); if(!m_navigatorwindow) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+NAVIGATORWINDOW+" not found"); return(false); } m_navigator=ControlGetHandle(m_terminal,NAVIGATOR); if(!m_navigator) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+NAVIGATOR+" not found"); return(false); } m_navigatortabs=ControlGetHandle(m_terminal,NAVIGATOR_TAB_BAR); if(!m_navigatortabs) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+NAVIGATOR_TAB_BAR+" not found"); return(false); } StringInit(m_buffer,1000); return(true); }
ChartExpertAddd() 用来把智能交易系统加载到图表。 该函数参数包括：
- p_type - 程序类型，智能交易系统或脚本，
- ea_name - 脚本或智能交易系统的名称，它与导航窗口中显示的完全匹配，但不包含文件扩展名。
- ea_relative_path - 依据 ea_name 参数给定的程序名，相对于 Scripts 或 Experts 的文件夹路径，例如下图所示的智能系统 Controls，它包含在 Experts 文件夹下的 Examples 子文件夹，名为 Controls，因此其路径为 Examples\Controls。 如果程序不在 Scripts 或 Experts 文件夹的任何子文件夹中，则此参数应设置为 NULL 或 “”。
- ea_set_file 是设置文件 .set 的文件名。 对于此参数，指定文件扩展名为 .set。
- chart_symbol 和 chart_tf 参数指定程序将被加载到的图表的属性。
首先调用 SwitchToNewChart() 方法。 该方法在当前打开的图表窗口中搜索请求的图表。 如果找到了，则设置焦点指向它，否则调用 ChartOpen() 函数打开新图表。 该方法还负责设置类的 m_chartid 属性。
然后依据 m_chartid 属性检查程序是否已添加到图表之上。 如果程序存在，则该方法返回 “true”。
//+------------------------------------------------------------------+ //|sets focus to existing or new chart window | //+------------------------------------------------------------------+ bool CTerminalController::SwitchToNewChart(string n_symbol,const ENUM_TIMEFRAMES n_tf) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } string sarray[]; StringToUpper(n_symbol); string newchartname=n_symbol+","+PeriodToString(n_tf); if(!WinMenuSelectItem(m_terminal,MENU_WINDOW,MENU_TILEWINDOWS,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to select menu item: Tile Windows"); return(false); } Sleep(200); string windowtext=WinGetText(m_terminal); int find=StringFind(windowtext,ChartSymbol(ChartFirst())+","+PeriodToString(ChartPeriod(ChartFirst()))); string chartstring=StringSubstr(windowtext,find); StringReplace(chartstring,"\n\n","\n"); int sarraysize=StringSplit(chartstring,StringGetCharacter("\n",0),sarray); bool found=false; int i; long prevChart=0; m_chartid=ChartFirst(); for(i=0; i<sarraysize; i++,) { if(sarray[i]=="") continue; if(i>0) m_chartid=ChartNext(prevChart); if(StringFind(sarray[i],newchartname)>=0) { found=true; break; } prevChart=m_chartid; } ArrayFree(sarray); HWND frameview=0; if(found) frameview=ControlGetHandle(m_terminal,newchartname); else if(ChartOpen(n_symbol,n_tf)) frameview=ControlGetHandle(m_terminal,newchartname); if(frameview) { if(!WinSetState(frameview,SW_MAXIMIZE)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Could not maximize "+newchartname+" chart window"); return(false); } } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Chart window "+newchartname+" not found"); return(false); } return(true); }
如果未找到该程序，则准备在“导航器”面板进行搜索。 如果“导航器”面板的“通用”选项卡不可见，则启用该选项卡
一旦启用，将调用 Findprogram() 方法基于 SYSTREView32 控件搜索 MetaTrader 5 程序。 该方法得助于递归方法 FindBranch()。
//+---------------------------------------------------------------------+ //|searches navigator for a program and outputs its location on the tree| //+---------------------------------------------------------------------+ bool CTerminalController::Findprogram(const ENUM_TYPE_PROGRAM pr_type,const string program_name,const string relative_path,string &sbuffer) { long listsize=GetTreeViewItemCount(m_terminal,m_navigator,"#0"); if(!listsize) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Root treeview control is empty"); return(false); } else { string rpath=""; if(relative_path=="") rpath=relative_path; else { if(StringFind(relative_path,"\\")==0) rpath=StringSubstr(relative_path,1); else rpath=relative_path; if(StringFind(rpath,"\\",StringLen(rpath)-1)<0) rpath+="\\"; } switch(pr_type) { case ENUM_TYPE_EXPERT: { string fullpath="Expert Advisors\\"+rpath+program_name; Findbranch(listsize,"#0",fullpath,sbuffer); break; } case ENUM_TYPE_SCRIPT: { string fullpath="Scripts\\"+rpath+program_name; Findbranch(listsize,"#0",fullpath,sbuffer); break; } default: Findbranch(listsize,"#0","",sbuffer); break; } } if(sbuffer=="") { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Operation failed could not find "+program_name); return(false); } else return(true); }
FindBranch() 遍历该控件，并构建字符串引用 ID，该 ID 指向 SYSTREVIEW32 控件上程序所处的路径。 该程序的引用 ID 是需要的，以便 AutoIt 据其选择程序，并添加到图表中。
//+-----------------------------------------------------------------------+ //|recursively searches systreeview for program and builds location string| //+-----------------------------------------------------------------------+ void CTerminalController::Findbranch(const long childrenOnBranch,const string index,const string pname,string &sbuffer) { if(pname=="" || index=="") { sbuffer=index; return; } else { if(childrenOnBranch<=0) return; else { int find=StringFind(pname,"\\"); long ss=0; long i; for(i=0; i<childrenOnBranch; i++) { ss=GetTreeViewItemCount(m_terminal,m_navigator,index+"|#"+IntegerToString(i)); string search=(find>=0)?StringSubstr(pname,0,find):pname; string treebranchtext=GetTreeViewItemText(m_terminal,m_navigator,index+"|#"+IntegerToString(i)); if(StringFind(treebranchtext,search)>=0 && StringLen(treebranchtext)==StringLen(search)) break; } string npath=(find>=0)?StringSubstr(pname,find+1):""; Findbranch(ss,(i<childrenOnBranch)?index+"|#"+IntegerToString(i):"",npath,sbuffer); } } return; }
此处，如果程序是智能系统，并且图表上已经有另一个 EA，则会弹出一个对话框，请求用户确认替换当前运行的智能系统。
如果启动的程序有输入项，于 do... while 模块里遍历选项卡，设置 .set 文件，并检查勾选按钮，在需要时启用自动交易和 dll 授权。
最后，该方法返回再次检查图表的结果，以便能确保图表是否已将程序加载到图表之中。
//+------------------------------------------------------------------+ //| Adds EA,Script,Service to a chart | //+------------------------------------------------------------------+ bool CTerminalController::ChartExpertAdd(const ENUM_TYPE_PROGRAM p_type,const string ea_name,const string ea_relative_path,const string ea_set_file,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf) { if(!SwitchToNewChart(chart_symbol,chart_tf)) { return(false); } if(StringFind((p_type==ENUM_TYPE_EXPERT)?ChartGetString(m_chartid,CHART_EXPERT_NAME):ChartGetString(m_chartid,CHART_SCRIPT_NAME),ea_name)>=0) { return(true); } if(p_type==ENUM_TYPE_EXPERT && StringFind(ChartGetString(m_chartid,CHART_EXPERT_NAME),ChartGetString(ChartID(),CHART_EXPERT_NAME))>=0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Cannot replace currenlty running Expert"); return(false); } if(StringLen(ea_set_file)>0) { if(StringFind(ea_relative_path,".set")<0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Incorrect parameter setting, set file name should contain .set file extension"); return(false); } } if(!IsControlVisible(m_terminal,m_navigator)) { if(!IsControlVisible(m_terminal,m_navigatorwindow)) { if(!WinMenuSelectItem(m_terminal,MENU_VIEW,MENU_NAVIGATOR,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to select menu item : Navigator"); return(false); } } if(!ControlLeftClick(m_terminal,m_navigatortabs,1,5,5)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to click on Navigator, Common tab"); return(false); } } string treepath=""; if(!Findprogram(p_type,ea_name,ea_relative_path,treepath)) return(false); if(!SelectTreeViewItem(m_terminal,m_navigator,treepath)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to select treeview item: "+treepath); return(false); } if(!ControlSend(m_terminal,m_navigator,"{SHIFTDOWN}{F10}{SHIFTUP}c",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Control Send failure"); return(false); } Sleep(500); m_program=WinGetHandle(ea_name); HWND dialogue=WinGetHandle(BrokerName()+" - MetaTrader 5",ea_name); if(!m_program && !dialogue) { if(p_type==ENUM_TYPE_EXPERT && StringFind(ChartGetString(m_chartid,CHART_EXPERT_NAME),ea_name)<0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Could not add program to chart"); return(false); } else { return(true); } } if(!m_program && dialogue)// replace current ea { HWND button = ControlGetHandle(dialogue,YES_BUTTON); if(button) { if(ControlLeftClick(dialogue,button)) { Sleep(200); m_program=WinGetHandle(ea_name); } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed left click on yes button"); WinClose(dialogue); return(false); } } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Yes button for dialogue not found"); WinClose(dialogue); return(false); } } m_systab32=ControlGetHandle(m_program,PROGRAM_WINDOW_TAB); if(!m_systab32) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+PROGRAM_WINDOW_TAB+ "not found"); return(false); } long totaltabs=TotalTabs(m_program,m_systab32); bool algoenabled=false; bool inputmod=false; bool dllenabled=(totaltabs<3)?true:false; do { string windowtext=WinGetText(m_program); if(StringFind(windowtext,WINDOWTEXT_DLL)>=0) { StringFill(windowtext,0); HWND button=ControlGetHandle(m_program,DLLCHECK_BUTTON); if(!button) { WinClose(m_program); { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"DLL check button not found"); return(false); } } if(!IsButtonChecked(m_program,button)) { if(CheckButton(m_program,button)) dllenabled=true; } else dllenabled=true; if(dllenabled) { if(TabLeft(m_program,m_systab32)) if(!TabLeft(m_program,m_systab32)) { inputmod=true; } } else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Could not enable DLL loading"); return(false); } } else if(StringFind(windowtext,WINDOWTEXT_EA)==0) { StringFill(windowtext,0); HWND button=ControlGetHandle(m_program,ALGOTRADECHECK_BUTTON); if(!button) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Algo check button not found"); return(false); } if(!IsButtonChecked(m_program,button)) { if(CheckButton(m_program,button)) algoenabled=true; } else algoenabled=true; if(algoenabled) { if(!inputmod) { if(!TabRight(m_program,m_systab32)) { HWND okbutton=ControlGetHandle(m_program,OK_BUTTON_3); if(!okbutton) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed find Ok button"); return(false); } if(!ControlLeftClick(m_program,okbutton)) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Left Click failure"); return(false); } else { break; } } } else { HWND okbutton=ControlGetHandle(m_program,OK_BUTTON_3); if(!okbutton) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed find Ok button"); return(false); } if(!ControlLeftClick(m_program,okbutton)) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Left Click failure"); return(false); } } } else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Unable to enable autotrading"); return(false); } } else if(StringFind(windowtext,WINDOWTEXT_INPUT)==0) { StringFill(windowtext,0); HWND button=ControlGetHandle(m_program,LOAD_BUTTON); HWND okbutton=ControlGetHandle(m_program,(totaltabs>2)?OK_BUTTON_1:OK_BUTTON_2); if(!okbutton) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to find OK button"); return(false); } if(StringLen(ea_set_file)>0) { if(!button) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to find .set file load button"); return(false); } if(!ControlLeftClick(m_program,button)) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Left click failure"); return(false); } HWND filewin=0; int try =50; while(!filewin && try >0) { filewin=WinGetHandle(FILEDIALOGE_WINDOW); try --; Sleep(200); } HWND filedit=ControlGetHandle(filewin,FILENAME_EDIT); if(!filedit || !filewin) { if(!filedit) { if(filewin) WinClose(filewin); } WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" File dialogue failure"); return(false); } if(ControlSetText(filewin,filedit,"")) { if(ControlSend(filewin,filedit,ea_set_file,1)) { Sleep(200); if(ControlSend(filewin,filedit,"{ENTER}",0)) Sleep(300); } } if(WinExists(filewin)) { WinClose(filewin); WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to set .set file through file dialogue"); return(false); } } inputmod=true; if(algoenabled) { if(ControlLeftClick(m_program,okbutton)) break; else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to click OK button"); return(false); } } else { if(!TabLeft(m_program,m_systab32)) { if(ControlLeftClick(m_program,okbutton)) break; else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to click OK button"); return(false); } } } } } while(!inputmod||!dllenabled||!algoenabled); int try =50; while(WinExists(m_program) && try >0) { Sleep(500); try --; } if(WinExists(m_program) && !try) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to add program to chart"); return(false); } if(p_type==ENUM_TYPE_EXPERT && StringFind(ChartGetString(m_chartid,CHART_EXPERT_NAME),ea_name)<0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Operation failed could not add program to chart"); return(false); } return(true); }
ChartExpertRemove() 从图表中卸载脚本或智能系统。 它通过主应用程序的菜单调用 Experts 窗口对话框来实现这一点。 然后，该方法遍历程序列表，并根据程序名和图表属性（即图表品种和时间帧）查找匹配项。
ChartExpertRemoveAll() 函数将删除所有 EA 和脚本，当然，排除实际执行删除操作的程序
//+------------------------------------------------------------------+ //|Removes EA,Script from a chart | //+------------------------------------------------------------------+ bool CTerminalController::ChartExpertRemove(const string ea_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf) { return(RemoveExpert(ea_name,chart_symbol,chart_tf)); }
//+------------------------------------------------------------------+ //|Helper function detaches program from a chart | //+------------------------------------------------------------------+ bool CTerminalController::RemoveExpert(const string program_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } if(!WinMenuSelectItem(m_terminal,MENU_CHARTS,MENU_EXPERTS_LIST,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Menu selection failure."); return(false); } Sleep(200); m_expwindow=WinGetHandle(EXPERTS_WINDOW); if(!m_expwindow) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_WINDOW+" window not found"); return(false); } m_explistview=ControlGetHandle(m_expwindow,EXPERTS_WINDOW_LISTVIEW); if(!m_explistview) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_WINDOW_LISTVIEW+" control not found"); return(false); } HWND remove_button=ControlGetHandle(m_expwindow,EXPERTS_REMOVE_BUTTON); if(!remove_button) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Remove button not found"); return(false); } long listsize=GetListViewItemCount(m_expwindow,m_explistview); if(listsize<=0) { return(true); } string newchartname=chart_symbol; StringToUpper(newchartname); newchartname+=","+PeriodToString(chart_tf); bool found=false; ClearAllListViewItemSelections(m_expwindow,m_explistview); for(int i=0; i<int(listsize); i++) { if(!SelectListViewItem(m_expwindow,m_explistview,IntegerToString(i),"")) continue; string pname=GetListViewItemText(m_expwindow,m_explistview,IntegerToString(i),"0"); string chartname=GetListViewItemText(m_expwindow,m_explistview,IntegerToString(i),"1"); if(StringFind(pname,program_name)>=0 && StringFind(chartname,newchartname)>=0) { if(IsControlEnabled(m_expwindow,remove_button)) if(ControlLeftClick(m_expwindow,remove_button)) found=true; } if(found) break; ClearAllListViewItemSelections(m_expwindow,m_explistview); } WinClose(m_expwindow); return(found); }
GetLastExpertsLogEntry() 和 GetLastJournalEntry() 方法分别引用智能系统日志和流水帐日志的最后一条输出字符串。
这些方法与流水账或智能系统选项卡交互，不读取实际的日志文件，它们其实是从 listview32 控件中获取文本。 如果已手动清除选项卡，则这些方法无法直接从日志文件提取数据。
//+------------------------------------------------------------------+ //|Gets the last journal entry | //+------------------------------------------------------------------+ void CTerminalController::GetLastJournalEntry(string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } long listsize=GetListViewItemCount(m_terminal,m_journaltab); if(listsize<=0) return; ClipPut(""); if(!ClearAllListViewItemSelections(m_terminal,m_journaltab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(!SelectListViewItem(m_terminal,m_journaltab,IntegerToString(listsize-1),"")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select last listview item"); return; } if(!ControlSend(m_terminal,m_journaltab,"{LCTRL down}c{LCTRL up}",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(entry); StringTrimRight(entry); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_journaltab); return; } //+------------------------------------------------------------------+ //|Gets last entry made to experts log file | //+------------------------------------------------------------------+ void CTerminalController::GetLastExpertsLogEntry(string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } long listsize=GetListViewItemCount(m_terminal,m_expertstab); if(listsize<=0) return; ClipPut(""); if(!ClearAllListViewItemSelections(m_terminal,m_expertstab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(!SelectListViewItem(m_terminal,m_expertstab,IntegerToString(listsize-1),"")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select last listview item"); return; } if(!ControlSend(m_terminal,m_expertstab,"{LCTRL down}c{LCTRL up}",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(entry); StringTrimRight(entry); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_expertstab); return; }
GetLastExpertsLogEntryByText() 和 GetLastJournalEntryByText() 函数返回与 text_to_search_for 参数匹配的最后一条日志项。 这些函数按照时间逆流方向从最后的日志项开始搜索。 max_items_to_search_in 参数中设置要遍历的最大日志项数目。 例如，如果设置为 10，函数将遍历最后 10 个日志项，查找匹配项。 如果此参数设置为 0 或负数，则函数将遍历所有日志项。
//+------------------------------------------------------------------+ //|Gets last entry made to experts log file containg certain string | //+------------------------------------------------------------------+ void CTerminalController::GetLastExpertsLogEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } string items; string itemsarray[]; long listsize=GetListViewItemCount(m_terminal,m_expertstab); if(listsize<=0) return; long stop=(max_items_to_search_in>0)? listsize-max_items_to_search_in:0; if(!ClearAllListViewItemSelections(m_terminal,m_expertstab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(stop<=0) { if(!SelectAllListViewItems(m_terminal,m_expertstab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select all listview items"); return; } StringInit(items,int(listsize)*1000); } else { if(!SelectListViewItem(m_terminal,m_expertstab,IntegerToString(stop),IntegerToString(listsize-1))) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select "+IntegerToString(stop)+" listview items"); return; } StringInit(items,int(stop)*1000); } ClipPut(""); if(!ControlSend(m_terminal,m_expertstab,"{LCTRL down}c",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(items); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_expertstab); int a_size=StringSplit(items,StringGetCharacter("\n",0),itemsarray); for(int i=(a_size-1); i>=0; i--) { if(itemsarray[i]=="") continue; if(StringFind(itemsarray[i],text_to_search_for,24)>=24) { entry=itemsarray[i]; StringTrimRight(entry); break;; } } ArrayFree(itemsarray); return; } //+------------------------------------------------------------------+ //|Gets last entry made to journal containing certain string | //+------------------------------------------------------------------+ void CTerminalController::GetLastJournalEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } string items; string itemsarray[]; long listsize=GetListViewItemCount(m_terminal,m_journaltab); if(listsize<=0) return; long stop=(max_items_to_search_in>0)? listsize-max_items_to_search_in:0; if(!ClearAllListViewItemSelections(m_terminal,m_journaltab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(stop<=0) { if(!SelectAllListViewItems(m_terminal,m_journaltab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select all listview items"); return; } StringInit(items,int(listsize)*1000); } else { if(!SelectListViewItem(m_terminal,m_journaltab,IntegerToString(stop),IntegerToString(listsize-1))) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select "+IntegerToString(stop)+" listview items"); return; } StringInit(items,int(stop)*1000); } ClipPut(""); if(!ControlSend(m_terminal,m_journaltab,"{LCTRL down}c",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(items); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_journaltab); int a_size=StringSplit(items,StringGetCharacter("\n",0),itemsarray); for(int i=(a_size-1); i>=0; i--) { if(itemsarray[i]=="") continue; if(StringFind(itemsarray[i],text_to_search_for,24)>=24) { entry=itemsarray[i]; StringTrimRight(entry); break;; } } ArrayFree(itemsarray); return; }
SetNotificationId() 方法是针对该概念的原始演示的回溯。 它最多接受四个 MetaQuotes ID 的字符串参数。
//+------------------------------------------------------------------+ //|set the MetaQuotes id | //+------------------------------------------------------------------+ bool CTerminalController::SetNotificationId(const string MetaQuotes_id) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } string itemsarray[]; int totalids=StringSplit(MetaQuotes_id,StringGetCharacter(",",0),itemsarray); if(totalids>4) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Invalid parameter settings, Only maximum of 4 MetaQuotes ID's allowed"); return(false); } HWND opt_window,opt_tab,edit,ok,checkbutton1,checkbutton2,checkbutton3; if(!WinMenuSelectItem(m_terminal,MENU_TOOLS,MENU_OPTIONS,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Menu selection failure."); return(false); } Sleep(200); opt_window=WinGetHandle(OPTWINDOW); if(!opt_window) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Options Window not found."); return(false); } opt_tab=ControlGetHandle(opt_window,OPTWINDOW_TAB); if(!opt_tab) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Options Window tab control not found"); WinClose(opt_window); return(false); } RECT wnsize; WinClientSize(opt_window,wnsize); int y=5; int x=5; string wintext=WinGetText(opt_window); while(StringFind(wintext,NOTIFICATIONS_TEXT)<0) { if(x<wnsize.right && ControlLeftClick(opt_window,opt_tab,1,x,5)) { wintext=WinGetText(opt_window); x+=y; } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Notification settings tab not found"); WinClose(opt_window); return(false); } } checkbutton1=ControlGetHandle(opt_window,OPTWINDOW_CHECK_1); if(!checkbutton1) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Enable Notifications check button not found"); WinClose(opt_window); return(false); } checkbutton2=ControlGetHandle(opt_window,OPTWINDOW_CHECK_2); if(!checkbutton2) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Enable Notifications from terminal check button not found"); WinClose(opt_window); return(false); } checkbutton3=ControlGetHandle(opt_window,OPTWINDOW_CHECK_3); if(!checkbutton3) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Enable Notifications from trade server check button not found"); WinClose(opt_window); return(false); } ok=ControlGetHandle(opt_window,OPTWINDOW_OK); if(!ok) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"OK button not found"); WinClose(opt_window); return(false); } edit=ControlGetHandle(opt_window,OPTWINDOW_EDIT); if(!checkbutton1) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Notification Ids edit control not found"); WinClose(opt_window); return(false); } string current_id=ControlGetText(opt_window,edit); if(!StringCompare(current_id,MetaQuotes_id)) { WinClose(opt_window); return(true); } if(!IsButtonChecked(opt_window,checkbutton1)) CheckButton(opt_window,checkbutton1); if(IsControlEnabled(opt_window,checkbutton2) && !IsButtonChecked(opt_window,checkbutton2)) CheckButton(opt_window,checkbutton2); if(IsControlEnabled(opt_window,checkbutton3) && !IsButtonChecked(opt_window,checkbutton3)) CheckButton(opt_window,checkbutton3); if(ControlSetText(opt_window,edit,"")) ControlSend(opt_window,edit,MetaQuotes_id,1); if(ControlLeftClick(opt_window,ok)) Sleep(200); if(WinExists(opt_window)) WinClose(opt_window); return(true); }
调用 CloseAlertDialogue() 时，会查找任何警报的弹出窗口，并将其关闭。
//+------------------------------------------------------------------+ //| closes any pop up alert window | //+------------------------------------------------------------------+ void CTerminalController::CloseAlertDialogue(void) { static datetime lastcheck; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } if(WinExists(ALERTWINDOW,"")) { string alertmessage; StringInit(alertmessage,200); GetLastExpertsLogEntryByText(ALERTWINDOW,0,alertmessage); if(StringLen(alertmessage)>0) { datetime check=StringToTime(StringSubstr(alertmessage,0,24)); if(check>lastcheck && check>iTime(NULL,PERIOD_D1,0)) { WinClose(ALERTWINDOW,""); lastcheck=check; } } } return; }
整个类的代码如下所示
//+------------------------------------------------------------------+ //| terminalcontroller.mqh | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #include<autoItbase.mqh> #define JOURNAL_TAB "SysListView321" #define EXPERTS_TAB "SysListView327" #define NAVIGATOR "SysTreeView321" #define NAVIGATOR_TAB_BAR "AfxWnd140su3" #define PROGRAM_WINDOW_TAB "SysTabControl321" #define EXPERTS_WINDOW_LISTVIEW "SysListView321" #define EXPERTS_REMOVE_BUTTON "Button2" #define DLLCHECK_BUTTON "Button1" #define ALGOTRADECHECK_BUTTON "Button4" #define OK_BUTTON_1 "Button7" #define OK_BUTTON_2 "Button3" #define OK_BUTTON_3 "Button5" #define LOAD_BUTTON "Button1" #define YES_BUTTON "Button1" #define FILENAME_EDIT "Edit1" #define OPTWINDOW_TAB "SysTabControl321" #define OPTWINDOW_CHECK_1 "Button1" #define OPTWINDOW_CHECK_2 "Button2" #define OPTWINDOW_CHECK_3 "Button6" #define OPTWINDOW_OK "Button7" #define OPTWINDOW_EDIT "Edit1" #define EXPERTS_WINDOW "Experts" #define NAVIGATORWINDOW "Navigator" #define TOOLBOXWINDOW "Toolbox" #define FILEDIALOGE_WINDOW "Open" #define WINDOWTEXT_DLL "Allow DLL" #define WINDOWTEXT_EA "Expert Advisor settings" #define WINDOWTEXT_INPUT "Input" #define OPTWINDOW "Options" #define NOTIFICATIONS_TEXT "Enable Push notifications" #define ALERTWINDOW "Alert" #define MENU_TOOLS "&Tools" #define MENU_OPTIONS "&Options" #define MENU_WINDOW "&Window" #define MENU_TILEWINDOWS "&Tile Windows" #define MENU_VIEW "&View" #define MENU_NAVIGATOR "&Navigator" #define MENU_CHARTS "&Charts" #define MENU_EXPERTS_LIST "&Expert List" enum ENUM_TYPE_PROGRAM { ENUM_TYPE_EXPERT=0,//EXPERT_ADVISOR ENUM_TYPE_SCRIPT//SCRIPT }; //+------------------------------------------------------------------+ //|Class CTerminalController | //| Purpose: class for scripting the terminal | //+------------------------------------------------------------------+ class CTerminalController:public CAutoIt { private: HWND m_terminal; //terminal window handle HWND m_journaltab; //journal tab handle HWND m_expertstab; //experts tab handle HWND m_navigator; //navigator systreeview HWND m_navigatortabs; //navigator tab header HWND m_navigatorwindow; //navigator window HWND m_systab32; //handle to inputs tabbed control with in inputs dialogue HWND m_program; //window handle for user inputs dialogue HWND m_expwindow; //handle to window showing list of experts HWND m_explistview; //list view control for experts list in m_expwindow long m_chartid; //chart id long m_accountNum; //account number string m_buffer; //string buffer public: //default constructor CTerminalController(void): m_terminal(0), m_journaltab(0), m_expertstab(0), m_navigator(0), m_navigatortabs(0), m_navigatorwindow(0), m_systab32(0), m_program(0), m_expwindow(0), m_explistview(0), m_chartid(-1), m_buffer("") { m_accountNum=AccountInfoInteger(ACCOUNT_LOGIN); StringInit(m_buffer,1000); } //destructor ~CTerminalController(void) { } //public methods string GetErrorDetails(void) { return(m_buffer); } bool ChartExpertAdd(const ENUM_TYPE_PROGRAM p_type,const string ea_name,const string ea_relative_path,const string ea_set_file,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf); bool ChartExpertRemove(const string ea_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf); bool ChartExpertRemoveAll(void); void CloseAlertDialogue(void); void GetLastExpertsLogEntry(string &entry); void GetLastExpertsLogEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry); void GetLastJournalEntry(string &entry); void GetLastJournalEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry); bool Initialize(const long accountNumber=0); bool SwitchToNewChart(string n_symbol, const ENUM_TIMEFRAMES n_tf); bool SetNotificationId(const string MetaQuotes_id); bool ToggleAutoTrading(void); private: //helper methods void SetErrorDetails(const string text); void Findbranch(const long childrenOnBranch,const string index,const string pname,string& sbuffer); bool Findprogram(const ENUM_TYPE_PROGRAM pr_type, const string program_name,const string relative_path,string& sbuffer); string PeriodToString(const ENUM_TIMEFRAMES chart_tf); bool RemoveExpert(const string program_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf); string BrokerName(void); }; //+------------------------------------------------------------------+ //| sets or resets window and control handles used in the class | //+------------------------------------------------------------------+ bool CTerminalController::Initialize(const long accountNumber=0) { Init(); if(accountNumber>0 && accountNumber!=m_accountNum) { m_accountNum=accountNumber; m_program=m_expwindow=m_systab32=m_explistview=m_navigatorwindow=0; m_terminal=m_journaltab=m_expertstab=m_navigator=m_navigatortabs=0; m_chartid=0; } if(m_terminal) return(true); m_terminal=WinGetHandle(IntegerToString(m_accountNum)); if(!m_terminal) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Terminal window "+IntegerToString(m_accountNum)+" not found"); return(false); } m_journaltab=ControlGetHandle(m_terminal,JOURNAL_TAB); if(!m_journaltab) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+JOURNAL_TAB+" not found"); return(false); } m_expertstab=ControlGetHandle(m_terminal,EXPERTS_TAB); if(!m_expertstab) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_TAB+" not found"); return(false); } m_navigatorwindow=ControlGetHandle(m_terminal,NAVIGATORWINDOW); if(!m_navigatorwindow) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+NAVIGATORWINDOW+" not found"); return(false); } m_navigator=ControlGetHandle(m_terminal,NAVIGATOR); if(!m_navigator) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+NAVIGATOR+" not found"); return(false); } m_navigatortabs=ControlGetHandle(m_terminal,NAVIGATOR_TAB_BAR); if(!m_navigatortabs) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+NAVIGATOR_TAB_BAR+" not found"); return(false); } StringInit(m_buffer,1000); return(true); } //+------------------------------------------------------------------+ //|sets focus to existing or new chart window | //+------------------------------------------------------------------+ bool CTerminalController::SwitchToNewChart(string n_symbol,const ENUM_TIMEFRAMES n_tf) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } string sarray[]; StringToUpper(n_symbol); string newchartname=n_symbol+","+PeriodToString(n_tf); if(!WinMenuSelectItem(m_terminal,MENU_WINDOW,MENU_TILEWINDOWS,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to select menu item: Tile Windows"); return(false); } Sleep(200); string windowtext=WinGetText(m_terminal); int find=StringFind(windowtext,ChartSymbol(ChartFirst())+","+PeriodToString(ChartPeriod(ChartFirst()))); string chartstring=StringSubstr(windowtext,find); StringReplace(chartstring,"\n\n","\n"); int sarraysize=StringSplit(chartstring,StringGetCharacter("\n",0),sarray); bool found=false; int i; long prevChart=0; m_chartid=ChartFirst(); for(i=0; i<sarraysize; i++,) { if(sarray[i]=="") continue; if(i>0) m_chartid=ChartNext(prevChart); if(StringFind(sarray[i],newchartname)>=0) { found=true; break; } prevChart=m_chartid; } ArrayFree(sarray); HWND frameview=0; if(found) frameview=ControlGetHandle(m_terminal,newchartname); else if(ChartOpen(n_symbol,n_tf)) frameview=ControlGetHandle(m_terminal,newchartname); if(frameview) { if(!WinSetState(frameview,SW_MAXIMIZE)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Could not maximize "+newchartname+" chart window"); return(false); } } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Chart window "+newchartname+" not found"); return(false); } return(true); } //+------------------------------------------------------------------+ //| Adds EA,Script,Service to a chart | //+------------------------------------------------------------------+ bool CTerminalController::ChartExpertAdd(const ENUM_TYPE_PROGRAM p_type,const string ea_name,const string ea_relative_path,const string ea_set_file,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf) { if(!SwitchToNewChart(chart_symbol,chart_tf)) { return(false); } if(StringFind((p_type==ENUM_TYPE_EXPERT)?ChartGetString(m_chartid,CHART_EXPERT_NAME):ChartGetString(m_chartid,CHART_SCRIPT_NAME),ea_name)>=0) { return(true); } if(p_type==ENUM_TYPE_EXPERT && StringFind(ChartGetString(m_chartid,CHART_EXPERT_NAME),ChartGetString(ChartID(),CHART_EXPERT_NAME))>=0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Cannot replace currenlty running Expert"); return(false); } if(StringLen(ea_set_file)>0) { if(StringFind(ea_relative_path,".set")<0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Incorrect parameter setting, set file name should contain .set file extension"); return(false); } } if(!IsControlVisible(m_terminal,m_navigator)) { if(!IsControlVisible(m_terminal,m_navigatorwindow)) { if(!WinMenuSelectItem(m_terminal,MENU_VIEW,MENU_NAVIGATOR,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to select menu item : Navigator"); return(false); } } if(!ControlLeftClick(m_terminal,m_navigatortabs,1,5,5)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to click on Navigator, Common tab"); return(false); } } string treepath=""; if(!Findprogram(p_type,ea_name,ea_relative_path,treepath)) return(false); if(!SelectTreeViewItem(m_terminal,m_navigator,treepath)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to select treeview item: "+treepath); return(false); } if(!ControlSend(m_terminal,m_navigator,"{SHIFTDOWN}{F10}{SHIFTUP}c",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Control Send failure"); return(false); } Sleep(500); m_program=WinGetHandle(ea_name); HWND dialogue=WinGetHandle(BrokerName()+" - MetaTrader 5",ea_name); if(!m_program && !dialogue) { if(p_type==ENUM_TYPE_EXPERT && StringFind(ChartGetString(m_chartid,CHART_EXPERT_NAME),ea_name)<0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Could not add program to chart"); return(false); } else { return(true); } } if(!m_program && dialogue)// replace current ea { HWND button = ControlGetHandle(dialogue,YES_BUTTON); if(button) { if(ControlLeftClick(dialogue,button)) { Sleep(200); m_program=WinGetHandle(ea_name); } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed left click on yes button"); WinClose(dialogue); return(false); } } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Yes button for dialogue not found"); WinClose(dialogue); return(false); } } m_systab32=ControlGetHandle(m_program,PROGRAM_WINDOW_TAB); if(!m_systab32) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+PROGRAM_WINDOW_TAB+ "not found"); return(false); } long totaltabs=TotalTabs(m_program,m_systab32); bool algoenabled=false; bool inputmod=false; bool dllenabled=(totaltabs<3)?true:false; do { string windowtext=WinGetText(m_program); if(StringFind(windowtext,WINDOWTEXT_DLL)>=0) { StringFill(windowtext,0); HWND button=ControlGetHandle(m_program,DLLCHECK_BUTTON); if(!button) { WinClose(m_program); { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"DLL check button not found"); return(false); } } if(!IsButtonChecked(m_program,button)) { if(CheckButton(m_program,button)) dllenabled=true; } else dllenabled=true; if(dllenabled) { if(TabLeft(m_program,m_systab32)) if(!TabLeft(m_program,m_systab32)) { inputmod=true; } } else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Could not enable DLL loading"); return(false); } } else if(StringFind(windowtext,WINDOWTEXT_EA)==0) { StringFill(windowtext,0); HWND button=ControlGetHandle(m_program,ALGOTRADECHECK_BUTTON); if(!button) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Algo check button not found"); return(false); } if(!IsButtonChecked(m_program,button)) { if(CheckButton(m_program,button)) algoenabled=true; } else algoenabled=true; if(algoenabled) { if(!inputmod) { if(!TabRight(m_program,m_systab32)) { HWND okbutton=ControlGetHandle(m_program,OK_BUTTON_3); if(!okbutton) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed find Ok button"); return(false); } if(!ControlLeftClick(m_program,okbutton)) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Left Click failure"); return(false); } else { break; } } } else { HWND okbutton=ControlGetHandle(m_program,OK_BUTTON_3); if(!okbutton) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed find Ok button"); return(false); } if(!ControlLeftClick(m_program,okbutton)) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Left Click failure"); return(false); } } } else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Unable to enable autotrading"); return(false); } } else if(StringFind(windowtext,WINDOWTEXT_INPUT)==0) { StringFill(windowtext,0); HWND button=ControlGetHandle(m_program,LOAD_BUTTON); HWND okbutton=ControlGetHandle(m_program,(totaltabs>2)?OK_BUTTON_1:OK_BUTTON_2); if(!okbutton) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to find OK button"); return(false); } if(StringLen(ea_set_file)>0) { if(!button) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to find .set file load button"); return(false); } if(!ControlLeftClick(m_program,button)) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Left click failure"); return(false); } HWND filewin=0; int try =50; while(!filewin && try >0) { filewin=WinGetHandle(FILEDIALOGE_WINDOW); try --; Sleep(200); } HWND filedit=ControlGetHandle(filewin,FILENAME_EDIT); if(!filedit || !filewin) { if(!filedit) { if(filewin) WinClose(filewin); } WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" File dialogue failure"); return(false); } if(ControlSetText(filewin,filedit,"")) { if(ControlSend(filewin,filedit,ea_set_file,1)) { Sleep(200); if(ControlSend(filewin,filedit,"{ENTER}",0)) Sleep(300); } } if(WinExists(filewin)) { WinClose(filewin); WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to set .set file through file dialogue"); return(false); } } inputmod=true; if(algoenabled) { if(ControlLeftClick(m_program,okbutton)) break; else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to click OK button"); return(false); } } else { if(!TabLeft(m_program,m_systab32)) { if(ControlLeftClick(m_program,okbutton)) break; else { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to click OK button"); return(false); } } } } } while(!inputmod||!dllenabled||!algoenabled); int try =50; while(WinExists(m_program) && try >0) { Sleep(500); try --; } if(WinExists(m_program) && !try) { WinClose(m_program); SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Failed to add program to chart"); return(false); } if(p_type==ENUM_TYPE_EXPERT && StringFind(ChartGetString(m_chartid,CHART_EXPERT_NAME),ea_name)<0) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+" Operation failed could not add program to chart"); return(false); } return(true); } //+------------------------------------------------------------------+ //|Removes EA,Script from a chart | //+------------------------------------------------------------------+ bool CTerminalController::ChartExpertRemove(const string ea_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf) { return(RemoveExpert(ea_name,chart_symbol,chart_tf)); } //+------------------------------------------------------------------+ //| Removes all scripts and experts from all charts | //+------------------------------------------------------------------+ bool CTerminalController::ChartExpertRemoveAll(void) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } if(!WinMenuSelectItem(m_terminal,MENU_CHARTS,MENU_EXPERTS_LIST,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Menu selection failure."); return(false); } Sleep(200); m_expwindow=WinGetHandle(EXPERTS_WINDOW); if(!m_expwindow) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_WINDOW+" window not found"); return(false); } m_explistview=ControlGetHandle(m_expwindow,EXPERTS_WINDOW_LISTVIEW); if(!m_explistview) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_WINDOW_LISTVIEW+" control not found"); WinClose(m_expwindow); return(false); } HWND remove_button=ControlGetHandle(m_expwindow,EXPERTS_REMOVE_BUTTON); if(!remove_button) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Remove button not found"); WinClose(m_expwindow); return(false); } long listsize=GetListViewItemCount(m_expwindow,m_explistview); if(listsize<=1) { WinClose(m_expwindow); return(true); } string prgname; ENUM_PROGRAM_TYPE mql_program=(ENUM_PROGRAM_TYPE)MQLInfoInteger(MQL_PROGRAM_TYPE); switch(mql_program) { case PROGRAM_SCRIPT: { prgname=ChartGetString(ChartID(),CHART_SCRIPT_NAME); break; } case PROGRAM_EXPERT: { prgname=ChartGetString(ChartID(),CHART_EXPERT_NAME); break; } default: prgname=""; } if(prgname=="") { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Unable to determine name of current program"); WinClose(m_expwindow); return(false); } do { ClearAllListViewItemSelections(m_expwindow,m_explistview); for(int i=0; i<int(listsize); i++) { if(!SelectListViewItem(m_expwindow,m_explistview,IntegerToString(i),"")) continue; string pname=GetListViewItemText(m_expwindow,m_explistview,IntegerToString(i),"0"); if(StringFind(pname,prgname)<0) { if(IsControlEnabled(m_expwindow,remove_button)) { if(ControlLeftClick(m_expwindow,remove_button)) { listsize--; Sleep(500); break; } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Failed to click remove button"); break; } } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Remove button is disabled"); break; } } else { ClearAllListViewItemSelections(m_expwindow,m_explistview); continue; } } } while(listsize>1); while(WinExists(m_expwindow)) WinClose(m_expwindow); return(true); } //+------------------------------------------------------------------+ //|Gets the last journal entry | //+------------------------------------------------------------------+ void CTerminalController::GetLastJournalEntry(string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } long listsize=GetListViewItemCount(m_terminal,m_journaltab); if(listsize<=0) return; ClipPut(""); if(!ClearAllListViewItemSelections(m_terminal,m_journaltab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(!SelectListViewItem(m_terminal,m_journaltab,IntegerToString(listsize-1),"")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select last listview item"); return; } if(!ControlSend(m_terminal,m_journaltab,"{LCTRL down}c{LCTRL up}",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(entry); StringTrimRight(entry); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_journaltab); return; } //+------------------------------------------------------------------+ //|Gets last entry made to experts log file | //+------------------------------------------------------------------+ void CTerminalController::GetLastExpertsLogEntry(string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } long listsize=GetListViewItemCount(m_terminal,m_expertstab); if(listsize<=0) return; ClipPut(""); if(!ClearAllListViewItemSelections(m_terminal,m_expertstab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(!SelectListViewItem(m_terminal,m_expertstab,IntegerToString(listsize-1),"")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select last listview item"); return; } if(!ControlSend(m_terminal,m_expertstab,"{LCTRL down}c{LCTRL up}",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(entry); StringTrimRight(entry); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_expertstab); return; } //+------------------------------------------------------------------+ //|Gets last entry made to experts log file containg certain string | //+------------------------------------------------------------------+ void CTerminalController::GetLastExpertsLogEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } string items; string itemsarray[]; long listsize=GetListViewItemCount(m_terminal,m_expertstab); if(listsize<=0) return; long stop=(max_items_to_search_in>0)? listsize-max_items_to_search_in:0; if(!ClearAllListViewItemSelections(m_terminal,m_expertstab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(stop<=0) { if(!SelectAllListViewItems(m_terminal,m_expertstab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select all listview items"); return; } StringInit(items,int(listsize)*1000); } else { if(!SelectListViewItem(m_terminal,m_expertstab,IntegerToString(stop),IntegerToString(listsize-1))) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select "+IntegerToString(stop)+" listview items"); return; } StringInit(items,int(stop)*1000); } ClipPut(""); if(!ControlSend(m_terminal,m_expertstab,"{LCTRL down}c",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(items); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_expertstab); int a_size=StringSplit(items,StringGetCharacter("\n",0),itemsarray); for(int i=(a_size-1); i>=0; i--) { if(itemsarray[i]=="") continue; if(StringFind(itemsarray[i],text_to_search_for,24)>=24) { entry=itemsarray[i]; StringTrimRight(entry); break;; } } ArrayFree(itemsarray); return; } //+------------------------------------------------------------------+ //|Gets last entry made to journal containing certain string | //+------------------------------------------------------------------+ void CTerminalController::GetLastJournalEntryByText(const string text_to_search_for,const int max_items_to_search_in,string &entry) { entry=""; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } string items; string itemsarray[]; long listsize=GetListViewItemCount(m_terminal,m_journaltab); if(listsize<=0) return; long stop=(max_items_to_search_in>0)? listsize-max_items_to_search_in:0; if(!ClearAllListViewItemSelections(m_terminal,m_journaltab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to deselect all listview items"); return; } if(stop<=0) { if(!SelectAllListViewItems(m_terminal,m_journaltab)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select all listview items"); return; } StringInit(items,int(listsize)*1000); } else { if(!SelectListViewItem(m_terminal,m_journaltab,IntegerToString(stop),IntegerToString(listsize-1))) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to select "+IntegerToString(stop)+" listview items"); return; } StringInit(items,int(stop)*1000); } ClipPut(""); if(!ControlSend(m_terminal,m_journaltab,"{LCTRL down}c",0)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"failed to send keys to control"); return; } ClipGet(items); ClipPut(""); ClearAllListViewItemSelections(m_terminal,m_journaltab); int a_size=StringSplit(items,StringGetCharacter("\n",0),itemsarray); for(int i=(a_size-1); i>=0; i--) { if(itemsarray[i]=="") continue; if(StringFind(itemsarray[i],text_to_search_for,24)>=24) { entry=itemsarray[i]; StringTrimRight(entry); break;; } } ArrayFree(itemsarray); return; } //+------------------------------------------------------------------+ //|Helper function detaches program from a chart | //+------------------------------------------------------------------+ bool CTerminalController::RemoveExpert(const string program_name,const string chart_symbol,const ENUM_TIMEFRAMES chart_tf) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } if(!WinMenuSelectItem(m_terminal,MENU_CHARTS,MENU_EXPERTS_LIST,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Menu selection failure."); return(false); } Sleep(200); m_expwindow=WinGetHandle(EXPERTS_WINDOW); if(!m_expwindow) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_WINDOW+" window not found"); return(false); } m_explistview=ControlGetHandle(m_expwindow,EXPERTS_WINDOW_LISTVIEW); if(!m_explistview) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+EXPERTS_WINDOW_LISTVIEW+" control not found"); return(false); } HWND remove_button=ControlGetHandle(m_expwindow,EXPERTS_REMOVE_BUTTON); if(!remove_button) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Remove button not found"); return(false); } long listsize=GetListViewItemCount(m_expwindow,m_explistview); if(listsize<=0) { return(true); } string newchartname=chart_symbol; StringToUpper(newchartname); newchartname+=","+PeriodToString(chart_tf); bool found=false; ClearAllListViewItemSelections(m_expwindow,m_explistview); for(int i=0; i<int(listsize); i++) { if(!SelectListViewItem(m_expwindow,m_explistview,IntegerToString(i),"")) continue; string pname=GetListViewItemText(m_expwindow,m_explistview,IntegerToString(i),"0"); string chartname=GetListViewItemText(m_expwindow,m_explistview,IntegerToString(i),"1"); if(StringFind(pname,program_name)>=0 && StringFind(chartname,newchartname)>=0) { if(IsControlEnabled(m_expwindow,remove_button)) if(ControlLeftClick(m_expwindow,remove_button)) found=true; } if(found) break; ClearAllListViewItemSelections(m_expwindow,m_explistview); } WinClose(m_expwindow); return(found); } //+------------------------------------------------------------------+ //|helper method converts period names to string format | //+------------------------------------------------------------------+ string CTerminalController::PeriodToString(const ENUM_TIMEFRAMES chart_tf) { string strper=""; switch(chart_tf) { case PERIOD_MN1: strper="Monthly"; break; case PERIOD_W1: strper="Weekly"; break; case PERIOD_D1: strper="Daily"; break; default: strper=StringSubstr(EnumToString(chart_tf),StringFind(EnumToString(chart_tf),"_")+1); break; } return strper; } //+---------------------------------------------------------------------+ //|searches navigator for a program and outputs its location on the tree| //+---------------------------------------------------------------------+ bool CTerminalController::Findprogram(const ENUM_TYPE_PROGRAM pr_type,const string program_name,const string relative_path,string &sbuffer) { long listsize=GetTreeViewItemCount(m_terminal,m_navigator,"#0"); if(!listsize) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Root treeview control is empty"); return(false); } else { string rpath=""; if(relative_path=="") rpath=relative_path; else { if(StringFind(relative_path,"\\")==0) rpath=StringSubstr(relative_path,1); else rpath=relative_path; if(StringFind(rpath,"\\",StringLen(rpath)-1)<0) rpath+="\\"; } switch(pr_type) { case ENUM_TYPE_EXPERT: { string fullpath="Expert Advisors\\"+rpath+program_name; Findbranch(listsize,"#0",fullpath,sbuffer); break; } case ENUM_TYPE_SCRIPT: { string fullpath="Scripts\\"+rpath+program_name; Findbranch(listsize,"#0",fullpath,sbuffer); break; } default: Findbranch(listsize,"#0","",sbuffer); break; } } if(sbuffer=="") { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Operation failed could not find "+program_name); return(false); } else return(true); } //+-----------------------------------------------------------------------+ //|recursively searches systreeview for program and builds location string| //+-----------------------------------------------------------------------+ void CTerminalController::Findbranch(const long childrenOnBranch,const string index,const string pname,string &sbuffer) { if(pname=="" || index=="") { sbuffer=index; return; } else { if(childrenOnBranch<=0) return; else { int find=StringFind(pname,"\\"); long ss=0; long i; for(i=0; i<childrenOnBranch; i++) { ss=GetTreeViewItemCount(m_terminal,m_navigator,index+"|#"+IntegerToString(i)); string search=(find>=0)?StringSubstr(pname,0,find):pname; string treebranchtext=GetTreeViewItemText(m_terminal,m_navigator,index+"|#"+IntegerToString(i)); if(StringFind(treebranchtext,search)>=0 && StringLen(treebranchtext)==StringLen(search)) break; } string npath=(find>=0)?StringSubstr(pname,find+1):""; Findbranch(ss,(i<childrenOnBranch)?index+"|#"+IntegerToString(i):"",npath,sbuffer); } } return; } //+------------------------------------------------------------------+ //| Get the broker name from the terminal window title | //+------------------------------------------------------------------+ string CTerminalController::BrokerName(void) { string full_title=WinGetTitle(m_terminal); int find=StringFind(full_title,"-"); string m_brokername=StringSubstr(full_title,find+1,StringFind(full_title,"-",find+1)-find-1); StringTrimLeft(m_brokername); StringTrimRight(m_brokername); return(m_brokername); } //+------------------------------------------------------------------+ //| Set error details | //+------------------------------------------------------------------+ void CTerminalController::SetErrorDetails(const string _text) { StringFill(m_buffer,0); m_buffer=_text; return; } //+------------------------------------------------------------------+ //|set the MetaQuotes id | //+------------------------------------------------------------------+ bool CTerminalController::SetNotificationId(const string MetaQuotes_id) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } string itemsarray[]; int totalids=StringSplit(MetaQuotes_id,StringGetCharacter(",",0),itemsarray); if(totalids>4) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Invalid parameter settings, Only maximum of 4 MetaQuotes ID's allowed"); return(false); } HWND opt_window,opt_tab,edit,ok,checkbutton1,checkbutton2,checkbutton3; if(!WinMenuSelectItem(m_terminal,MENU_TOOLS,MENU_OPTIONS,"","","","","","")) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Menu selection failure."); return(false); } Sleep(200); opt_window=WinGetHandle(OPTWINDOW); if(!opt_window) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Options Window not found."); return(false); } opt_tab=ControlGetHandle(opt_window,OPTWINDOW_TAB); if(!opt_tab) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Options Window tab control not found"); WinClose(opt_window); return(false); } RECT wnsize; WinClientSize(opt_window,wnsize); int y=5; int x=5; string wintext=WinGetText(opt_window); while(StringFind(wintext,NOTIFICATIONS_TEXT)<0) { if(x<wnsize.right && ControlLeftClick(opt_window,opt_tab,1,x,5)) { wintext=WinGetText(opt_window); x+=y; } else { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Notification settings tab not found"); WinClose(opt_window); return(false); } } checkbutton1=ControlGetHandle(opt_window,OPTWINDOW_CHECK_1); if(!checkbutton1) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Enable Notifications check button not found"); WinClose(opt_window); return(false); } checkbutton2=ControlGetHandle(opt_window,OPTWINDOW_CHECK_2); if(!checkbutton2) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Enable Notifications from terminal check button not found"); WinClose(opt_window); return(false); } checkbutton3=ControlGetHandle(opt_window,OPTWINDOW_CHECK_3); if(!checkbutton3) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Enable Notifications from trade server check button not found"); WinClose(opt_window); return(false); } ok=ControlGetHandle(opt_window,OPTWINDOW_OK); if(!ok) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"OK button not found"); WinClose(opt_window); return(false); } edit=ControlGetHandle(opt_window,OPTWINDOW_EDIT); if(!checkbutton1) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"Notification Ids edit control not found"); WinClose(opt_window); return(false); } string current_id=ControlGetText(opt_window,edit); if(!StringCompare(current_id,MetaQuotes_id)) { WinClose(opt_window); return(true); } if(!IsButtonChecked(opt_window,checkbutton1)) CheckButton(opt_window,checkbutton1); if(IsControlEnabled(opt_window,checkbutton2) && !IsButtonChecked(opt_window,checkbutton2)) CheckButton(opt_window,checkbutton2); if(IsControlEnabled(opt_window,checkbutton3) && !IsButtonChecked(opt_window,checkbutton3)) CheckButton(opt_window,checkbutton3); if(ControlSetText(opt_window,edit,"")) ControlSend(opt_window,edit,MetaQuotes_id,1); if(ControlLeftClick(opt_window,ok)) Sleep(200); if(WinExists(opt_window)) WinClose(opt_window); return(true); } //+------------------------------------------------------------------+ //| closes any pop up alert window | //+------------------------------------------------------------------+ void CTerminalController::CloseAlertDialogue(void) { static datetime lastcheck; if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return; } if(WinExists(ALERTWINDOW,"")) { string alertmessage; StringInit(alertmessage,200); GetLastExpertsLogEntryByText(ALERTWINDOW,0,alertmessage); if(StringLen(alertmessage)>0) { datetime check=StringToTime(StringSubstr(alertmessage,0,24)); if(check>lastcheck && check>iTime(NULL,PERIOD_D1,0)) { WinClose(ALERTWINDOW,""); lastcheck=check; } } } return; } //+------------------------------------------------------------------+ //|Enable and disable autotrading | //+------------------------------------------------------------------+ bool CTerminalController::ToggleAutoTrading(void) { if(!IsInitialized()) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } if(!ControlSend(m_terminal,m_navigatortabs,"{LCTRL down}e{LCTRL up}",1)) { SetErrorDetails(__FUNCTION__+" "+string(__LINE__)+". "+"AutoIt library not Initialized"); return(false); } return(true); } //+------------------------------------------------------------------+
使用 CTerminalController 类
第一个示例演示如何往图表中添加程序，以及如何删除程序。 添加程序名，并指定图表。 最后一个输入参数指示所添加程序将以秒为单位运行多长时间。 在指定的时间之后，如果程序仍在运行，它将被删除。
//+------------------------------------------------------------------+ //| TerminalController.mq5 | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #property version "1.00" #include<terminalcontroller.mqh> //--- input parameters input string ProgramName="Controls"; input string Path="Examples\\Controls"; input string Symbolname="BTCUSD"; input ENUM_TIMEFRAMES Timeframe=PERIOD_D1; input ENUM_TYPE_PROGRAM Type=0; input string SetFileName=""; input int RemoveProgramTimer=10;//Max seconds added program will run CTerminalController terminal; //+------------------------------------------------------------------+ //| Expert initialization function | //+------------------------------------------------------------------+ int OnInit() { //--- if(!terminal.Initialize()) { Print("Service failed to initialize CTerminalController instance"); return(INIT_FAILED); } if(!terminal.ChartExpertAdd(Type,ProgramName,Path,SetFileName,Symbolname,Timeframe)) Print("Failed to add "+ProgramName+" to chart. Error > "+terminal.GetErrorDetails()); if(RemoveProgramTimer>0) EventSetTimer(RemoveProgramTimer); else EventSetTimer(10); //--- return(INIT_SUCCEEDED); } //+------------------------------------------------------------------+ //| Expert deinitialization function | //+------------------------------------------------------------------+ void OnDeinit(const int reason) { //--- } //+------------------------------------------------------------------+ //| Expert tick function | //+------------------------------------------------------------------+ void OnTick() { //--- } //+------------------------------------------------------------------+ //| Expert timer function | //+------------------------------------------------------------------+ void OnTimer(void) { if(!terminal.ChartExpertRemove(ProgramName,Symbolname,Timeframe)) { Print("Failed to remove "+ProgramName+". Error > "+terminal.GetErrorDetails()); } else { string comment; terminal.GetLastJournalEntry(comment); Print(comment); ExpertRemove(); } } //+------------------------------------------------------------------+
HandleAlerts 智能交易系统会在每次新柱线出现时，发送一个直观的弹出警告。 然后调用 CloseAlertDialogue() 方法关闭终端生成的任何弹出式对话框。
//+------------------------------------------------------------------+ //| HandleAlerts.mq5 | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #property version "1.00" #include<terminalcontroller.mqh> //--- input parameters input int Seconds=5; CTerminalController terminal; //+------------------------------------------------------------------+ //| Expert initialization function | //+------------------------------------------------------------------+ int OnInit() { //--- if(!terminal.Initialize()) { Print("Service failed to initialize CTerminalController instance"); return(INIT_FAILED); } if(Seconds>0) EventSetTimer(Seconds); else EventSetTimer(10); //--- return(INIT_SUCCEEDED); } //+------------------------------------------------------------------+ //| Expert deinitialization function | //+------------------------------------------------------------------+ void OnDeinit(const int reason) { //--- } //+------------------------------------------------------------------+ //| Expert tick function | //+------------------------------------------------------------------+ void OnTick() { //--- static datetime lastsend; if(iTime(NULL,0,0)!=lastsend) { Alert("New Alert message sent at "+TimeToString(TimeCurrent())); } } //+------------------------------------------------------------------+ //| Expert Timer functions | //+------------------------------------------------------------------+ void OnTimer() { terminal.CloseAlertDialogue(); } //+------------------------------------------------------------------+
最后一个例子是 Send Push 脚本，该脚本的工作原理与文章《通过 DLL 管理 MetaTrader 终端》中提供的示例类似。
//+------------------------------------------------------------------+ //| Send_Push.mq5 | //| Copyright 2021, MetaQuotes Ltd. | //| https://www.mql5.com | //+------------------------------------------------------------------+ #property copyright "Copyright 2021, MetaQuotes Ltd." #property link "https://www.mql5.com " #property version "1.00" #property script_show_inputs #include<terminalcontroller.mqh> //--- input parameters input string message_text="test"; input string Mq_ID="1C2F1442,2C2F1442,3C2F1442,4C2F1442"; CTerminalController terminal; //+------------------------------------------------------------------+ //| Script program start function | //+------------------------------------------------------------------+ void OnStart() { //--- if(!terminal.Initialize()) { Print("Service failed to initialize CTerminalController instance"); return; } if(!terminal.SetNotificationId(Mq_ID)) { Print("Failed to set MetaQuotes id's. Error > "+terminal.GetErrorDetails()); return; } if(!SendNotification(message_text)) { int Err=GetLastError(); switch(Err) { case 4515: Alert("Waiting: Failed to send ", Mq_ID); break; case 4516: Alert("Err: Invalid message text ", message_text); return; break; case 4517: Alert("Waiting: Invalid ID list ", Mq_ID); break; case 4518: Alert("Err: Too frequent requests! "); return; break; } } } //+------------------------------------------------------------------+
结束语
本文简要介绍了如何使用 AutoIt。 我们观察了如何把 AutoItX 链接库与 MQL5 集成，还记录了运用 AutoITDLL 创建类的全过程。 使用该链接库时发现的唯一限制是，如果 MetaTrader 5 程序同时运行两个或多个 AutoItX 的副本，则将发生访问冲突错误。 因此，建议在 MetaTrader 5 程序当中只运行 AutoItX 代码的单个实例。
| 文件夹 | 内容 | 说明 |
|---|---|---|
| MetaTrader 5zip\MQL5\include | autoIt.mqh, autoItbase.mqh,terminalcontroller.mqh | autoIt.mqh 包含 AutoItX 函数导入语句，autoItbase.mqh 包含 CAutoIt 类，terminalcontroller.mqh 包含一个 MinalController 类 |
| MetaTrader 5zip\MQL5\Experts | TerminalController.mq5,HandleAlerts.mq5 | TerminalController EA 演示了从图表中自动删除和添加智能交易系统或脚本。 HandleAlerts EA 展示了如何自动处理弹出警报窗口 |
| MetaTrader 5zip\MQL5\Scripts | TerminalUIComponents.mq5,Send_Push.mq5 | TerminalUicomPents 通过直接调用导入的函数来演示 AutoItX 的运用，Send_Push 脚本在发送通知之前向终端添加新的 MetaQuotes ID |
本文由MetaQuotes Ltd译自英文
原文地址： https://www.mql5.com/en/articles/10130
附加的文件 |
Mt5.zip
(15.46 KB)
注意: MetaQuotes Ltd.将保留所有关于这些材料的权利。全部或部分复制或者转载这些材料将被禁止。
前往讨论
DoEasy 函数库中的图形（第八十九部分）：标准图形对象编程。 基本功能
目前，该函数库能够跟踪客户端终端图表上的标准图形对象，包括删除和修改其某些参数。 在当下，它还缺乏从自定义程序创建标准图形对象的能力。
固化价格动作止损或固化 RSI（智能止损）
在交易中，止损是资金管理采用的主要工具。 有效利用止损、获利回吐和成交量可以使交易者在交易中更加一致，总体上更加有利可图。 尽管止损是一个极好的工具，但在运用中也会遇到一些挑战。 最主要的是止损猎杀（stop-loss hunt）。 本文展望如何降低交易中的猎杀，并与经典的止损用例进行比较，从而判定其盈利能力。
