MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のChartIndicatorAddとChartIndicatorDelete、ハンドルを渡すだけでチャートに載せられる手軽さと短縮名を頼りに狙って外せる確実さどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のChartIndicatorAddとChartIndicatorDelete、ハンドルを渡すだけでチャートに載せられる手軽さと短縮名を頼りに狙って外せる確実さどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のChartIndicatorAddとChartIndicatorDeleteの比較

この記事を開いてくださったこと、心から感謝しています。プログラムからチャートにインジケーターを載せたり外したりしたいと考えたとき、どの関数を使えばよいか迷った人も多いはずです。

結論から言うと、インジケーターのハンドルを持っていて載せたいならChartIndicatorAdd、載っているものを短縮名で外したいならChartIndicatorDeleteが向いています。

ただし、失敗したときの細かなエラーコードなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・短縮名・注意点・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のChartIndicatorAddとChartIndicatorDeleteの違いをまとめたインフォグラフィック
目次

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の記事が参考になります。

載せる関数はハンドル、外す関数は短縮名と分かって、整理できました。調べてよかったです。
連動して消えることがあると知って、使う前の確認ができて安心しました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
2つを見比べたら、場面ごとの選び方が整理されて、コードを書くのが楽しみになりました。

もう1つのコツは、戻り値のboolを必ず確かめ、falseのときにGetLastErrorをログに残すことです。公式のサンプルも、この形で書かれています。

  • 戻り値のboolを必ず確認する
  • falseならGetLastErrorをログに出す
  • 使い終わったハンドルは解放する

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

chart_idに0を渡すと、どうなるのか?

公式ページには、0は現在のチャートを意味する、と書かれています。ほかのチャートを対象にしたいときは、そのチャートのIDを渡します。

  • 0は現在のチャート
  • ほかのチャートはIDを渡す

短縮名は、どうやって調べるのか?

チャート上の短縮名は、ChartIndicatorNameで取得できます。何個あるかはChartIndicatorsTotalで調べられるため、ループで順に取り出す書き方が、公式のサンプルにあります。

  • ChartIndicatorsTotalで個数を調べる
  • ChartIndicatorNameで名前を取り出す
  • ウィンドウごとに繰り返す

この記事の例は、実際の結果なのか?

いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。

  • 仮の前提による例
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のChartIndicatorAddとChartIndicatorDelete、ハンドルを渡すだけでチャートに載せられる手軽さと短縮名を頼りに狙って外せる確実さどっちを選ぶ?」

ハンドルを持っていて載せたいならChartIndicatorAdd、載っているものを短縮名で外したいならChartIndicatorDeleteが向いています。記載のない点は、自分の環境で確かめましょう。

  • 載せるならChartIndicatorAdd
  • 外すならChartIndicatorDelete
  • 記載なしの点は自分で確かめる

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(ChartIndicatorAdd)
  • MQL5 リファレンス(ChartIndicatorDelete)
  • MQL5 リファレンス(ChartIndicatorName)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のObjectGetTimeByValueとObjectGetValueByTime、価格から時間を逆算して探せる便利さと時間から価格を読み取れる素直さどっちを選ぶ?
  • MQL5のChartXYToTimePriceとChartTimePriceToXY、クリックした画面の位置から時間と価格を割り出せる便利さと時間と価格から画面上の位置を求められる使いやすさどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次