この記事を開いてくださったこと、心から感謝しています。プログラムからチャートにインジケーターを載せたり外したりしたいと考えたとき、どの関数を使えばよいか迷った人も多いはずです。
結論から言うと、インジケーターのハンドルを持っていて載せたいならChartIndicatorAdd、載っているものを短縮名で外したいならChartIndicatorDeleteが向いています。
ただし、失敗したときの細かなエラーコードなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・短縮名・注意点・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartIndicatorAddとChartIndicatorDeleteは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはチャートに載せる関数で、もう1つはチャートから外す関数です。
ChartIndicatorAddは、ハンドルを渡して載せる
MQL5公式リファレンスによると、ChartIndicatorAddは、指定したハンドルのインジケーターを、指定したチャートのウィンドウに追加する関数です。戻り値はbool型で、成功すればtrueです。
引数は、チャートID・サブウィンドウ番号・インジケーターのハンドルの3つです。ハンドルは、iMACDなどの関数で先に作っておく必要があります。
- ハンドルを渡して追加する
- 引数はチャートID・サブウィンドウ番号・ハンドル
- 戻り値はbool型(成功ならtrue)
ChartIndicatorDeleteは、短縮名を渡して外す
ChartIndicatorDeleteは、指定した名前のインジケーターを、指定したチャートのウィンドウから削除する関数です。戻り値はbool型で、削除に成功すればtrueです。
引数は、チャートID・サブウィンドウ番号・インジケーターの短縮名の3つです。ハンドルではなく、名前で相手を指定するところが、大きな違いです。
- 短縮名を渡して削除する
- 引数はチャートID・サブウィンドウ番号・短縮名
- 戻り値はbool型(成功ならtrue)
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartIndicatorAdd | ChartIndicatorDelete |
|---|---|---|
| 役割 | チャートに追加する | チャートから削除する |
| 相手の指定 | ハンドル(int) | 短縮名(string) |
| 引数の数 | 3つ | 3つ |
| 戻り値 | bool | bool |
| エラーの調べ方 | GetLastErrorを使う | GetLastErrorを使う |
※公式の説明をもとにした、筆者の整理です。
ChartIndicatorAddで、載せる場所はどう決まるのか?
追加する関数では、どのウィンドウに載せるかを決める引数が大切です。公式ページに書かれている決まりを整理します。
サブウィンドウ番号の決まり
公式ページによると、サブウィンドウ番号が0のときはメインのチャートウィンドウを指します。新しいウィンドウに追加したいときは、CHART_WINDOWS_TOTALと同じ値を指定します。
この値より大きい番号を渡すと、新しいウィンドウは作られず、インジケーターも追加されない、と書かれています。番号の飛ばしすぎには注意が必要です。
- 0はメインのチャートウィンドウ
- 新しいウィンドウはCHART_WINDOWS_TOTALと同じ値
- それより大きいと追加されない
チャートとインジケーターの条件
公式ページには、インジケーターとチャートは、同じ銘柄・同じ時間足で作られている必要がある、と書かれています。違う場合は失敗し、エラー4114になります。
たとえばチャートがAUDUSDなのに、別の銘柄のハンドルを渡すと、追加できません。ハンドルを作るときの銘柄と時間足を、チャートに合わせておくことが大切です。
| 条件 | 公式ページでの扱い |
|---|---|
| 銘柄と時間足が同じ | 追加できる |
| 銘柄か時間足が違う | 失敗し、エラー4114 |
| 番号がCHART_WINDOWS_TOTALより大きい | 追加されない |
| それ以外のエラーコード | 記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
別ウィンドウ向けを本体に載せた場合
公式ページには、別ウィンドウ向けのインジケーターをメインウィンドウに載せると、見えなくなることがある、と書かれています。スケールが価格と違うため、値が表示範囲に入らないからです。
この場合でも、インジケーターの一覧には残っており、GetLastErrorは0を返す、とも書かれています。値はデータウィンドウで見られ、ほかのプログラムからも読めます。
- 見えなくても、一覧には残っている
- GetLastErrorは0を返す
- データウィンドウで値は確認できる
ChartIndicatorDeleteで、短縮名はなぜ大切なのか?
削除する関数は、相手を短縮名で探します。そのため、短縮名の付け方が、そのまま動きの確かさにつながります。
短縮名の正体
公式ページによると、短縮名は、IndicatorSetStringでINDICATOR_SHORTNAMEに設定した名前です。ChartIndicatorNameを使うと、チャート上のインジケーターの短縮名を取得できます。
ファイル名とは別のものだと、公式ページは注意しています。短縮名を設定していない場合は、コンパイル時のソースファイル名が使われる、とも書かれています。
- IndicatorSetStringで設定する
- ChartIndicatorNameで取得できる
- ファイル名とは別のもの
- 未設定ならソースファイル名が使われる
同じ名前が2つあるとき
公式ページには、同じ短縮名のインジケーターが同じサブウィンドウに2つあるとき、並びの先頭にあるものが削除される、と書かれています。狙った1つだけを消せるとは限りません。
これを避けるため、短縮名には、すべての入力パラメータの値を含めるのが望ましい、と書かれています。名前から設定が区別できると、安全です。
| 状況 | 公式ページでの扱い |
|---|---|
| 同じ短縮名が2つある | 先頭の1つが削除される |
| 短縮名にパラメータを含める | 望ましいと記載あり |
| 短縮名が見つからない場合 | 記載なし |
| 具体的なエラーコード | 記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
削除するときに、気をつけたい点はどこか?
削除の関数には、追加の関数にはない注意点があります。公式ページに書かれている点を整理します。
連動して消えるインジケーターがある
公式ページによると、削除するインジケーターの値をもとにしている別のインジケーターが同じチャートにあれば、それらも一緒に削除されます。1つ消したつもりが、複数消える場合があります。
- 値をもとにした別のインジケーターも消える
- 消す前に、チャートの構成を確認する
- 意図しない削除を防ぐ工夫が必要
メモリの解放は別の話
公式ページには、チャートから外しても、インジケーターの計算コードが端末のメモリから解放されるわけではない、と書かれています。解放にはIndicatorReleaseを使います。
ハンドルを作ったプログラムが、不要になったハンドルを解放する、という流れです。チャートから外すことと、ハンドルを解放することは、別の作業です。
| 作業 | 使う関数 |
|---|---|
| チャートに載せる | ChartIndicatorAdd |
| チャートから外す | ChartIndicatorDelete |
| ハンドルを解放する | IndicatorRelease |
※公式の説明から読み取れる内容を、筆者が整理しました。
公式のサンプルは、どう書かれているのか?
ここでは、公式ページにあるサンプルの流れを見ていきます。それぞれの関数の使いどころが、よく分かります。
ChartIndicatorAddのサンプルは、わざとエラーを出す
サンプルは、AUDUSDとM12の設定で、iMACDのハンドルを作るEAです。入力した銘柄や時間足がチャートと違うときは、警告を出し、確認のうえで追加を試します。
追加は、ResetLastErrorで直前のエラーを消してから、新しいウィンドウを指定して実行します。違うときはエラー4114が出ることを、ログで確認する作りです。
- iMACDのハンドルを作る
- チャートと条件が違えば警告を出す
- 追加の失敗は、エラーコードで確認する
ChartIndicatorDeleteのサンプルは、自分で自分を外す
サンプルは、別ウィンドウに表示するカスタムインジケーターです。入力のwrong_initがtrueのときは、初期化で失敗を返し、終了処理の中で、自分自身をチャートから外します。
終了の理由がREASON_INITFAILEDのときに、ChartWindowFindでウィンドウ番号を調べ、短縮名を指定して削除します。失敗したら、エラーコードをログに出します。
| サンプル | やっていること |
|---|---|
| ChartIndicatorAdd | ハンドルを作り、新しいウィンドウに追加する |
| ChartIndicatorDelete | 初期化に失敗したら、自分を短縮名で外す |
※公式のサンプルの内容を、筆者が整理しました。
ここから読み取れることと、読み取れないこと
サンプルから、追加は、ハンドルと条件を整えたうえで呼ぶ関数だと読み取れます。一方で、失敗したときの細かなエラーコードの一覧は、記載なしでした。
| 確認できること | 確認できないこと |
|---|---|
| 追加の失敗はエラー4114になる例がある | ほかのエラーコードの一覧 |
| 削除は短縮名を使う | 短縮名が見つからないときの動き |
| 自分自身を外す使い方ができる | 削除後の戻り値の細かな意味 |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
EAを動かすとき、チャートに移動平均線を1本載せて、終了時にきれいに外したい場合を考えます。
- 移動平均線のハンドルを作ってある
- 終了時にチャートを元の状態に戻したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
起動時は、追加で載せる
起動時には、ハンドルをChartIndicatorAddに渡して、メインウィンドウに載せます。銘柄と時間足が同じなら、そのまま追加できる流れです。
- ハンドルを作る
- サブウィンドウ番号を決める
- 追加の結果を確認する
終了時は、削除で外す
終了時には、短縮名を指定して、ChartIndicatorDeleteで外します。そのあと、IndicatorReleaseでハンドルを解放すると、後片づけまで終わります。
| 場面(仮) | 使う関数 |
|---|---|
| 起動時に載せる | ChartIndicatorAdd |
| 終了時に外す | ChartIndicatorDelete |
| ハンドルの後片づけ | IndicatorRelease |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。結局のところ、載せたいのか外したいのかで決まります。
載せたいなら、ChartIndicatorAddを選ぶ
ハンドルを持っていて、チャートに表示したいときは、ChartIndicatorAddが向いています。計算だけして表示はしない使い方から、表示を足したい場合にも合います。
FX口座・ツールの比較一覧もあわせて確認してみてください。
外したいなら、ChartIndicatorDeleteを選ぶ
すでに載っているインジケーターを、名前で狙って外したいときは、ChartIndicatorDeleteが向いています。短縮名を、事前に決めておくことがポイントです。
チャート全体の見た目をまとめて整える方法については、ChartApplyTemplateとChartSetIntegerの記事で整理しています。個別に外す場合と、まとめて整える場合を、見比べると分かりやすくなります。
- 載っているものを名前で狙って外したい
- 終了時にチャートを元に戻したい
- 短縮名にパラメータを含めている
小さく試して、動きを確かめる
いきなり多くのインジケーターで使わず、移動平均線を1本だけ載せて外すところから始めましょう。表示位置の動かし方は、ChartNavigateとChartSetIntegerの記事が参考になります。









もう1つのコツは、戻り値のboolを必ず確かめ、falseのときにGetLastErrorをログに残すことです。公式のサンプルも、この形で書かれています。
- 戻り値のboolを必ず確認する
- falseならGetLastErrorをログに出す
- 使い終わったハンドルは解放する
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
chart_idに0を渡すと、どうなるのか?
公式ページには、0は現在のチャートを意味する、と書かれています。ほかのチャートを対象にしたいときは、そのチャートのIDを渡します。
- 0は現在のチャート
- ほかのチャートはIDを渡す
短縮名は、どうやって調べるのか?
チャート上の短縮名は、ChartIndicatorNameで取得できます。何個あるかはChartIndicatorsTotalで調べられるため、ループで順に取り出す書き方が、公式のサンプルにあります。
- ChartIndicatorsTotalで個数を調べる
- ChartIndicatorNameで名前を取り出す
- ウィンドウごとに繰り返す
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartIndicatorAddとChartIndicatorDelete、ハンドルを渡すだけでチャートに載せられる手軽さと短縮名を頼りに狙って外せる確実さどっちを選ぶ?」
ハンドルを持っていて載せたいならChartIndicatorAdd、載っているものを短縮名で外したいならChartIndicatorDeleteが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










