[MT4][プログラミング][入門] 1. EA初期フォーマットサンプルコード

/*****************************/
/* propety setting  ・・・ A */
/*****************************/
#property copyright   "2020-2021, x corp."
#property version     "1.00"
#property strict

/*****************************/
/* Input variables  ・・・ B */
/*****************************/
input double	parameter1		= 1.0;

/******************************/
/* Global variables  ・・・ C */
/******************************/
double 			glovalValue1	= 1.0;

/************************************/
/* Event Handing Functions ・・・ D */
/************************************/
int OnInit(void)
{
	int ret = INIT_SUCCEEDED;
	
	// 下記に該当するタイミングで呼び出される関数
	// 1. プログラム読み込み直後。
	// 2. このプログラムが追加されているChart上で時間足が変更された時。
	// 3. このプログラムがChartに追加されている状態で、このプログラムを再コンパイルした時。
	// 4. このプログラムのセットアップ画面でパラメータが変更(再度OKを押された場合も)された時
	// 5. アカウントが変更された時。
	
	// OnTimer()を使用する場合に周期を設定
	if(EventSetTimer(60) == false)	{ ret = INIT_FAILED; }
	
	// 返却値の意味は以下。(特にこの関数でチェックがない場合は固定値でINIT_SUCCEEDEDでも問題ありません)
	// INIT_SUCCEEDED            : 問題なく本関数が完了した際に使用
	// INIT_FAILED               : 初期化に失敗した場合に使用
	// INIT_PARAMETERS_INCORRECT : 入力されたパラメータが不正な場合に使用
	return ret;
}

void OnDeinit(const int reason)
{
	// 本関数で実行できる処理は2.5秒未満である必要があります。
	// ２.5秒を超えると強制終了されます。
	// 特に実装したい処理がない場合は実装しなくても問題ありません。
	
	// 下記に該当するタイミングで呼び出される関数
	// 1. チャートからプログラムを削除した時。
	// 2. このプログラムがChartに追加されている状態で、MT4アプリが閉じられる時。
	// 3. このプログラムがChartに追加されている状態で、Chartが閉じられる時。
	// 4. このプログラムがChartに追加されている状態で、Chartの時間足を変更する直前。
	// 5. このプログラムがChartに追加されている状態で、このプログラムを再コンパイルした時。
	// 6. このプログラムのセットアップ画面でパラメータが変更(再度OKを押された場合も)された時
	// 7. アカウントが変更された時。
	// 8. OnInit（）で、INIT_SUCCEEDED以外を返却したとき
	
	// reasonごとの処理。
	if(reason == REASON_PROGRAM)          { /* プログラム内で、ExpertRemove()が呼び出された時 */ }
	else if(reason == REASON_REMOVE)      { /* Chartからプログラムが削除された時 */              }
	else if(reason == REASON_RECOMPILE)   { /* このプログラムが再コンパイルされた時 */           }
	else if(reason == REASON_CHARTCHANGE) { /* Chartの通貨ペアまたは、時間足が変更された時 */    }
	else if(reason == REASON_CHARTCLOSE)  { /* Chartが閉じられた時 */                            }
	else if(reason == REASON_PARAMETERS)  { /* Inputパラメータが変更された時 */                  }
	else if(reason == REASON_ACCOUNT)     { /* アカウントが変更された時 */                       }
	else if(reason == REASON_TEMPLATE)    { /* 新しいテンプレートが適用された時 */               }
	else if(reason == REASON_INITFAILED)  { /* OnInit()でINIT_SUCCEEDED以外を設定した時 */       }
	else if(reason == REASON_CLOSE)       { /* MT4がクローズされるときの処理 */                  }
	
	// OnTimer()を使用する場合は、ここの関数でTimerイベントを停止する必要がある。
	EventKillTimer();
	
	return;
}

void OnTick(void)
{
	// 本関数処理中に、再度OnTick()が呼び出されるタイミングになった場合は、
	// 現在の処理を継続して新しいOnTick()イベントは破棄されます。
	// 本関数は、MT4の自動売買ボタンがON/OFF関係なく呼び出されます。
	
	// 下記に該当するタイミングで呼び出される関数
	// 1. 通貨ペアのTickごと(値の変動ごと)のタイミング
	
	return;
}

void OnTimer(void)
{
	// 下記に該当するタイミングで呼び出される関数
	// 1. OnInit()でEventSetTimer()により設定した周期のタイミング
	
	return;
}

void OnChartEvent(const int id,         // Event ID
                  const long& lparam,   // Parameter of type long event
                  const double& dparam, // Parameter of type double event
                  const string& sparam) // Parameter of type string events
{

	// 下記に該当するタイミングで呼び出される関数
	// 1. Chart上で発生したEventごとのタイミング(それぞれのイベントタイプは下記処理を確認してください)
	
	// チャートイベントごとの処理
	// それぞれのイベントごとの詳細Parameterは下記URLを参照ください
	// URL : https://docs.mql4.com/constants/chartconstants/enum_chartevents
	if     (id == CHARTEVENT_KEYDOWN)        { /* キーボードによる入力があった時のイベント */                                          }
	else if(id == CHARTEVENT_MOUSE_MOVE)     { /* マウスのクリックや移動の時のイベント(CHART_EVENT_MOUSE_MOVE=true 設定要) */          }
	else if(id == CHARTEVENT_OBJECT_CREATE)  { /* グラフィカルオブジェクトの生成時のイベント(CHART_EVENT_OBJECT_CREATE=true 設定要) */ }
	else if(id == CHARTEVENT_OBJECT_CHANGE)  { /* グラフィカルオブジェクトのプロパティを変更したときのイベント */                      }
	else if(id == CHARTEVENT_OBJECT_DELETE)  { /* グラフィカルオブジェクトの削除時のイベント(CHART_EVENT_OBJECT_DELETE=true 設定要) */ }
	else if(id == CHARTEVENT_CLICK)          { /* マウスでクリックした時のイベント */                                                  }
	else if(id == CHARTEVENT_OBJECT_CLICK)   { /* グラフィカルオブジェクトをクリックしたときのイベント */                              }
	else if(id == CHARTEVENT_OBJECT_DRAG)    { /* グラフィカルオブジェクトを動かしたときのイベント */                                  }
	else if(id == CHARTEVENT_OBJECT_ENDEDIT) { /* グラフィカルオブジェクトのテキストの編集を終了したときのイベント */                  }
	else if(id == CHARTEVENT_CHART_CHANGE)   { /* チャートを動かした場合のイベント */                                                  }
	else if(id == CHARTEVENT_CUSTOM)         { /* EventChartCustom()で指定されるカスタムイベントIDの最初のIDのイベント */              }
	else if(id == CHARTEVENT_CUSTOM_LAST)    { /* EventChartCustom()で指定されるカスタムイベントIDの最後のIDのイベント */              }
	
	return;
}