gavindiaz/mtapi
1
0
Fork 0
mirror of https://github.com/vdemydiuk/mtapi.git synced 2026-07-27 18:47:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

Issue #110: Implemented function for working with global variables (MT5)

Browse Source
This commit is contained in:
vdemydiuk
2018-06-04 13:53:55 +03:00
parent f71151104b
commit ca3c0e735f
6 changed files with 507 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
MtApi5/Mt5CommandType.cs
+14 -1
View File
@@ -235,6 +235,19 @@ namespace MtApi5
Print = 68,
ResetLastError = 143,
SendNotification = 144, //TODO
SendMail = 145 //TODO
SendMail = 145, //TODO
//Global Variables
GlobalVariableCheck = 146,
GlobalVariableTime = 147,
GlobalVariableDel = 148,
GlobalVariableGet = 149,
GlobalVariableName = 150,
GlobalVariableSet = 151,
GlobalVariablesFlush = 152,
GlobalVariableTemp = 154,
GlobalVariableSetOnCondition = 156,
GlobalVariablesDeleteAll = 157,
GlobalVariablesTotal = 158
}
}
MtApi5/MtApi5Client.cs
+117
View File
@@ -2894,6 +2894,123 @@ namespace MtApi5
#endregion
#region Global Variables
///<summary>
///Checks the existence of a global variable with the specified name.
///</summary>
///<param name="name">Global variable name.</param>
public bool GlobalVariableCheck(string name)
{
var commandParameters = new ArrayList { name };
return SendCommand<bool>(Mt5CommandType.GlobalVariableCheck, commandParameters);
}
///<summary>
///Returns the time when the global variable was last accessed.
///</summary>
///<param name="name">Name of the global variable.</param>
public DateTime GlobalVariableTime(string name)
{
var commandParameters = new ArrayList { name };
var res = SendCommand<int>(Mt5CommandType.GlobalVariableTime, commandParameters);
return Mt5TimeConverter.ConvertFromMtTime(res);
}
///<summary>
///Deletes a global variable from the client terminal.
///</summary>
///<param name="name">Name of the global variable.</param>
public bool GlobalVariableDel(string name)
{
var commandParameters = new ArrayList { name };
return SendCommand<bool>(Mt5CommandType.GlobalVariableDel, commandParameters);
}
///<summary>
///Returns the value of an existing global variable of the client terminal.
///</summary>
///<param name="name">Global variable name.</param>
public double GlobalVariableGet(string name)
{
var commandParameters = new ArrayList { name };
return SendCommand<double>(Mt5CommandType.GlobalVariableGet, commandParameters);
}
///<summary>
///Returns the name of a global variable by its ordinal number.
///</summary>
///<param name="index">Sequence number in the list of global variables. It should be greater than or equal to 0 and less than GlobalVariablesTotal().</param>
public string GlobalVariableName(int index)
{
var commandParameters = new ArrayList { index };
return SendCommand<string>(Mt5CommandType.GlobalVariableName, commandParameters);
}
///<summary>
///Sets a new value for a global variable. If the variable does not exist, the system creates a new global variable.
///</summary>
///<param name="name">Global variable name.</param>
///<param name="value">The new numerical value.</param>
public DateTime GlobalVariableSet(string name, double value)
{
var commandParameters = new ArrayList { name, value };
var res = SendCommand<int>(Mt5CommandType.GlobalVariableSet, commandParameters);
return Mt5TimeConverter.ConvertFromMtTime(res);
}
///<summary>
///Forcibly saves contents of all global variables to a disk.
///</summary>
public void GlobalVariablesFlush()
{
SendCommand<object>(Mt5CommandType.GlobalVariablesFlush, null);
}
///<summary>
///The function attempts to create a temporary global variable. If the variable doesn't exist, the system creates a new temporary global variable.
///</summary>
///<param name="name">The name of a temporary global variable.</param>
public bool GlobalVariableTemp(string name)
{
var commandParameters = new ArrayList { name };
return SendCommand<bool>(Mt5CommandType.GlobalVariableTemp, commandParameters);
}
///<summary>
///Sets the new value of the existing global variable if the current value equals to the third parameter check_value. If there is no global variable, the function will generate an error ERR_GLOBALVARIABLE_NOT_FOUND (4501) and return false.
///</summary>
///<param name="name">The name of a global variable.</param>
///<param name="value">New value.</param>
///<param name="checkValue">The value to check the current value of the global variable.</param>
public bool GlobalVariableSetOnCondition(string name, double value, double checkValue)
{
var commandParameters = new ArrayList { name, value, checkValue };
return SendCommand<bool>(Mt5CommandType.GlobalVariableSetOnCondition, commandParameters);
}
///<summary>
///Deletes global variables of the client terminal.
///</summary>
///<param name="prefixName">Name prefix global variables to remove. If you specify a prefix NULL or empty string, then all variables that meet the data criterion will be deleted.</param>
///<param name="limitData">Date to select global variables by the time of their last modification. The function removes global variables, which were changed before this date. If the parameter is zero, then all variables that meet the first criterion (prefix) are deleted.</param>
public int GlobalVariablesDeleteAll(string prefixName = "", DateTime? limitData = null)
{
if (prefixName == null)
prefixName = "";
var commandParameters = new ArrayList { prefixName, Mt5TimeConverter.ConvertToMtTime(limitData) };
return SendCommand<int>(Mt5CommandType.GlobalVariablesDeleteAll, commandParameters);
}
///<summary>
///Returns the total number of global variables of the client terminal.
///</summary>
public int GlobalVariablesTotal()
{
return SendCommand<int>(Mt5CommandType.GlobalVariablesTotal, null);
}
#endregion
#endregion // Public Methods
#region Properties
TestClients/MtApi5TestClient/MainWindow.xaml
+36
View File
@@ -586,6 +586,42 @@
</Grid>
</Grid>
</TabItem>
<TabItem Header="Global Variables">
<Grid Margin="5">
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="Auto"/>
</Grid.RowDefinitions>
<Grid Grid.Row="0">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto"/>
<ColumnDefinition Width="*"/>
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="Auto"/>
</Grid.RowDefinitions>
<TextBlock Grid.Column="0" Grid.Row="0" Text="Global Variable Name" Margin="2,0,0,0"/>
<TextBox Grid.Column="1" Grid.Row="0" Text="{Binding GlobalVarName}" Margin="4,0,0,0"/>
<TextBlock Grid.Column="0" Grid.Row="1" Text="Global Variable Value" Margin="2,2,0,0"/>
<TextBox Grid.Column="1" Grid.Row="1" Text="{Binding GlobalVarValue}" Margin="4,2,0,0"/>
</Grid>
<WrapPanel VerticalAlignment="Top" Grid.Row="1" Margin="0,5,0,0">
<Button Command="{Binding GlobalVariableCheckCommand}" Content="GlobalVariableCheck" Margin="2"/>
<Button Command="{Binding GlobalVariableTimeCommand}" Content="GlobalVariableTime" Margin="2"/>
<Button Command="{Binding GlobalVariableDelCommand}" Content="GlobalVariableDel" Margin="2"/>
<Button Command="{Binding GlobalVariableGetCommand}" Content="GlobalVariableGet" Margin="2"/>
<Button Command="{Binding GlobalVariableNameCommand}" Content="GlobalVariableName" Margin="2"/>
<Button Command="{Binding GlobalVariableSetCommand}" Content="GlobalVariableSet" Margin="2"/>
<Button Command="{Binding GlobalVariablesFlushCommand}" Content="GlobalVariablesFlush" Margin="2"/>
<Button Command="{Binding GlobalVariableTempCommand}" Content="GlobalVariableTemp" Margin="2"/>
<Button Command="{Binding GlobalVariableSetOnConditionCommand}" Content="GlobalVariableSetOnCondition" Margin="2"/>
<Button Command="{Binding GlobalVariablesDeleteAllCommand}" Content="GlobalVariablesDeleteAll" Margin="2"/>
<Button Command="{Binding GlobalVariablesTotalCommand}" Content="GlobalVariablesTotal" Margin="2"/>
</WrapPanel>
</Grid>
</TabItem>
</TabControl>
</Grid>
TestClients/MtApi5TestClient/ViewModel.cs
+126
View File
@@ -108,6 +108,18 @@ namespace MtApi5TestClient
public DelegateCommand TimeTradeServerCommand { get; private set; }
public DelegateCommand TimeLocalCommand { get; private set; }
public DelegateCommand TimeGMTCommand { get; private set; }
public DelegateCommand GlobalVariableCheckCommand { get; private set; }
public DelegateCommand GlobalVariableTimeCommand { get; private set; }
public DelegateCommand GlobalVariableDelCommand { get; private set; }
public DelegateCommand GlobalVariableGetCommand { get; private set; }
public DelegateCommand GlobalVariableNameCommand { get; private set; }
public DelegateCommand GlobalVariableSetCommand { get; private set; }
public DelegateCommand GlobalVariablesFlushCommand { get; private set; }
public DelegateCommand GlobalVariableTempCommand { get; private set; }
public DelegateCommand GlobalVariableSetOnConditionCommand { get; private set; }
public DelegateCommand GlobalVariablesDeleteAllCommand { get; private set; }
public DelegateCommand GlobalVariablesTotalCommand { get; private set; }
#endregion
#region Properties
@@ -229,6 +241,28 @@ namespace MtApi5TestClient
OnPropertyChanged("ChartFunctionsChartIdValue");
}
}
private string _globalVarName;
public string GlobalVarName
{
get { return _globalVarName; }
set
{
_globalVarName = value;
OnPropertyChanged("GlobalVarName");
}
}
private double _globalVarValue;
public double GlobalVarValue
{
get { return _globalVarValue; }
set
{
_globalVarValue = value;
OnPropertyChanged("GlobalVarValue");
}
}
#endregion
#region Public Methods
@@ -365,6 +399,18 @@ namespace MtApi5TestClient
TimeTradeServerCommand = new DelegateCommand(ExecuteTimeTradeServer);
TimeLocalCommand = new DelegateCommand(ExecuteTimeLocal);
TimeGMTCommand = new DelegateCommand(ExecuteTimeGMT);
GlobalVariableCheckCommand = new DelegateCommand(ExecuteGlobalVariableCheck);
GlobalVariableTimeCommand = new DelegateCommand(ExecuteGlobalVariableTime);
GlobalVariableDelCommand = new DelegateCommand(ExecuteGlobalVariableDel);
GlobalVariableGetCommand = new DelegateCommand(ExecuteGlobalVariableGet);
GlobalVariableNameCommand = new DelegateCommand(ExecuteGlobalVariableName);
GlobalVariableSetCommand = new DelegateCommand(ExecuteGlobalVariableSet);
GlobalVariablesFlushCommand = new DelegateCommand(ExecuteGlobalVariablesFlush);
GlobalVariableTempCommand = new DelegateCommand(ExecuteGlobalVariableTemp);
GlobalVariableSetOnConditionCommand = new DelegateCommand(ExecuteGlobalVariableSetOnCondition);
GlobalVariablesDeleteAllCommand = new DelegateCommand(ExecuteGlobalVariablesDeleteAll);
GlobalVariablesTotalCommand = new DelegateCommand(ExecuteGlobalVariablesTotal);
}
private bool CanExecuteConnect(object o)
@@ -1115,6 +1161,86 @@ namespace MtApi5TestClient
AddLog($"TimeGMT: {retVal}");
}
#region Global Variable Commands
private async void ExecuteGlobalVariableCheck(object obj)
{
var name = GlobalVarName;
var retVal = await Execute(() => _mtApiClient.GlobalVariableCheck(name));
AddLog($"GlobalVariableCheck: {retVal}");
}
private async void ExecuteGlobalVariableTime(object obj)
{
var name = GlobalVarName;
var retVal = await Execute(() => _mtApiClient.GlobalVariableTime(name));
AddLog($"GlobalVariableTime: {retVal}");
}
private async void ExecuteGlobalVariableDel(object obj)
{
var name = GlobalVarName;
var retVal = await Execute(() => _mtApiClient.GlobalVariableDel(name));
AddLog($"GlobalVariableDel: {retVal}");
}
private async void ExecuteGlobalVariableGet(object obj)
{
var name = GlobalVarName;
var retVal = await Execute(() => _mtApiClient.GlobalVariableGet(name));
GlobalVarValue = retVal;
AddLog($"GlobalVariableGet: {retVal}");
}
private async void ExecuteGlobalVariableName(object obj)
{
var retVal = await Execute(() => _mtApiClient.GlobalVariableName(0));
GlobalVarName = retVal;
AddLog($"GlobalVariableName: {retVal}");
}
private async void ExecuteGlobalVariableSet(object obj)
{
var name = GlobalVarName;
var value = GlobalVarValue;
var retVal = await Execute(() => _mtApiClient.GlobalVariableSet(name, value));
AddLog($"GlobalVariableSet: {retVal}");
}
private void ExecuteGlobalVariablesFlush(object obj)
{
_mtApiClient.GlobalVariablesFlush();
AddLog("GlobalVariablesFlush: executed.");
}
private async void ExecuteGlobalVariableTemp(object obj)
{
var name = GlobalVarName;
var retVal = await Execute(() => _mtApiClient.GlobalVariableTemp(name));
AddLog($"GlobalVariableTemp: {retVal}");
}
private async void ExecuteGlobalVariableSetOnCondition(object obj)
{
var name = GlobalVarName;
var value = GlobalVarValue;
const double checkValue = 2;
var retVal = await Execute(() => _mtApiClient.GlobalVariableSetOnCondition(name, value, checkValue));
AddLog($"GlobalVariableSetOnCondition: {retVal}");
}
private async void ExecuteGlobalVariablesDeleteAll(object obj)
{
var retVal = await Execute(() => _mtApiClient.GlobalVariablesDeleteAll());
AddLog($"GlobalVariablesDeleteAll: {retVal}");
}
private async void ExecuteGlobalVariablesTotal(object obj)
{
var retVal = await Execute(() => _mtApiClient.GlobalVariablesTotal());
AddLog($"GlobalVariablesTotal: {retVal}");
}
#endregion
#region Chart Commands
private async void ExecuteChartOpen(object o)
{
mq5/MtApi5.ex5
BIN
View File
Binary file not shown.
mq5/MtApi5.mq5
+214
View File
@@ -705,9 +705,42 @@ int executeCommand()
case 143: //ResetLastError
Execute_ResetLastError();
break;
case 146: //GlobalVariableCheck
Execute_GlobalVariableCheck();
break;
case 147: //GlobalVariableTime
Execute_GlobalVariableTime();
break;
case 148: //GlobalVariableDel
Execute_GlobalVariableDel();
break;
case 149: //GlobalVariableGet
Execute_GlobalVariableGet();
break;
case 150: //GlobalVariableName
Execute_GlobalVariableName();
break;
case 151: //GlobalVariableSet
Execute_GlobalVariableSet();
break;
case 152: //GlobalVariablesFlush
Execute_GlobalVariablesFlush();
break;
case 153: //TerminalInfoString
Execute_TerminalInfoString();
break;
case 154: //GlobalVariableTemp
Execute_GlobalVariableTemp();
break;
case 156: //GlobalVariableSetOnCondition
Execute_GlobalVariableSetOnCondition();
break;
case 157: //GlobalVariablesDeleteAll
Execute_GlobalVariablesDeleteAll();
break;
case 158: //GlobalVariablesTotal
Execute_GlobalVariablesTotal();
break;
case 204: //TerminalInfoInteger
Execute_TerminalInfoInteger();
break;
@@ -5659,6 +5692,114 @@ void Execute_ResetLastError()
SEND_VOID_RESPONSE
}
void Execute_GlobalVariableCheck()
{
string name;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s", __FUNCTION__, name);
#endif
bool res = GlobalVariableCheck(name);
SEND_BOOL_RESPONSE(res)
}
void Execute_GlobalVariableTime()
{
string name;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s", __FUNCTION__, name);
#endif
datetime time = GlobalVariableTime(name);
SEND_INT_RESPONSE((int)time)
}
void Execute_GlobalVariableDel()
{
string name;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s", __FUNCTION__, name);
#endif
bool res = GlobalVariableDel(name);
SEND_BOOL_RESPONSE(res)
}
void Execute_GlobalVariableGet()
{
string name;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s", __FUNCTION__, name);
#endif
double res = GlobalVariableGet(name);
SEND_DOUBLE_RESPONSE(res)
}
void Execute_GlobalVariableName()
{
int index;
GET_INT_VALUE(0, index, "index")
#ifdef __DEBUG_LOG__
PrintFormat("%s: index = %d", __FUNCTION__, index);
#endif
string name = GlobalVariableName(index);
SEND_STRING_RESPONSE(name)
}
void Execute_GlobalVariableSet()
{
string name;
double value;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
GET_DOUBLE_VALUE(1, value, "value")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s, value = %f", __FUNCTION__, name, value);
#endif
datetime res = GlobalVariableSet(name, value);
SEND_INT_RESPONSE((int)res)
}
void Execute_GlobalVariablesFlush()
{
#ifdef __DEBUG_LOG__
PrintFormat("%s: called.", __FUNCTION__);
#endif
GlobalVariablesFlush();
SEND_VOID_RESPONSE
}
void Execute_ChartOpen()
{
string symbol;
@@ -6247,6 +6388,79 @@ void Execute_TerminalInfoString()
}
}
void Execute_GlobalVariableTemp()
{
string name;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s", __FUNCTION__, name);
#endif
bool res = GlobalVariableTemp(name);
SEND_BOOL_RESPONSE(res)
}
void Execute_GlobalVariableSetOnCondition()
{
string name;
double value;
double check_value;
StringInit(name, 500);
GET_STRING_VALUE(0, name, "name")
GET_DOUBLE_VALUE(1, value, "value")
GET_DOUBLE_VALUE(2, check_value, "check_value")
#ifdef __DEBUG_LOG__
PrintFormat("%s: name = %s, value = %f, check_value = %f", __FUNCTION__, name, value, check_value);
#endif
bool res = GlobalVariableSetOnCondition(name, value, check_value);
#ifdef __DEBUG_LOG__
PrintFormat("%s: result = %s", __FUNCTION__, BoolToString(res));
#endif
SEND_BOOL_RESPONSE(res)
}
void Execute_GlobalVariablesDeleteAll()
{
string prefix_name;
int limit_data;
StringInit(prefix_name, 500);
GET_STRING_VALUE(0, prefix_name, "prefix_name")
GET_INT_VALUE(1, limit_data, "limit_data")
#ifdef __DEBUG_LOG__
PrintFormat("%s: prefix_name = %s, limit_data = %d", __FUNCTION__, prefix_name, limit_data);
#endif
int res = GlobalVariablesDeleteAll(prefix_name, (datetime)limit_data);
#ifdef __DEBUG_LOG__
PrintFormat("%s: result = %d", __FUNCTION__, res);
#endif
SEND_INT_RESPONSE(res)
}
void Execute_GlobalVariablesTotal()
{
int res = GlobalVariablesTotal();
#ifdef __DEBUG_LOG__
PrintFormat("%s: result = %d", __FUNCTION__, res);
#endif
SEND_INT_RESPONSE(res)
}
void Execute_TerminalInfoInteger()
{
int propertyId;