この記事を開いてくださったこと、心から感謝しています。MQL5のEAでチャートに部品を表示したあと、消し方で迷った人も多いはずです。
結論から言うと、名前を指定して1つずつ消したいならObjectDelete、接頭辞や種類でまとめて消したいならObjectsDeleteAllが向いています。
ただし、一部の細かい動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の仕組み・動き方の違い・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ObjectDeleteとObjectsDeleteAllは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。
ObjectDeleteは、名前を指定して1つ消す
MQL5公式リファレンスによると、ObjectDeleteは、チャートのIDと、消したいオブジェクトの名前を渡して使う関数です。チャートのIDに0を指定すると、今のチャートが対象になります。
種類やウィンドウで絞り込む引数はありません。接頭辞でまとめて指定する引数もありません。1回の呼び出しで、1つの名前だけを消す関数です。
- チャートIDと名前を渡す
- 絞り込みの引数はない
- 1回で消すのは1つだけ
ObjectsDeleteAllは、条件に合うものをまとめて消す
ObjectsDeleteAllには、2つの書き方があります。1つは、ウィンドウの番号と、オブジェクトの種類を指定する書き方です。もう1つは、名前の接頭辞を指定して、さらにウィンドウと種類で絞り込む書き方です。
ウィンドウの番号は、0がメインのウィンドウで、-1がすべてのウィンドウです。種類も、-1ならすべての種類が対象になります。
- ウィンドウと種類で消す書き方がある
- 接頭辞で消す書き方もある
- -1はすべてを意味する
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ObjectDelete | ObjectsDeleteAll |
|---|---|---|
| 消す数 | 名前の1つ | 条件に合う全部 |
| 絞り込み | なし | ウィンドウ、種類、接頭辞 |
| 動き方 | 非同期 | 同期 |
| 戻り値 | 命令を追加できたか | 消した数 |
※公式の説明をもとにした、筆者の整理です。
動き方には、どんな違いがあるのか?
次に、2つの関数の動き方の違いを見ていきます。ここが、使い分けで一番大切なところです。
ObjectDeleteは、非同期で動く
公式ページには、ObjectDeleteは、必ず非同期で呼ばれる、と書かれています。戻り値のtrueは、チャートの待ち行列に、命令を追加できたという意味です。消えたかどうかは、この時点では分かりません。
結果を確かめたいときは、ObjectFindやObjectGetなどを使う、という説明があります。これらは待ち行列の最後に入り、同期して待つので、オブジェクトが多いと遅くなる場合がある、とも書かれています。
- 戻り値は、命令を追加できたかどうか
- 消えたかはObjectFindで確かめる
- 確かめる呼び出しは遅くなる場合がある
ObjectsDeleteAllは、同期で動く
ObjectsDeleteAllのページには、同期の呼び出しを使う、と書かれています。この関数の前に、チャートの待ち行列に入っていた命令がすべて終わるのを待つので、時間がかかる場合がある、という説明です。
戻り値は、消したオブジェクトの数です。エラーの内容を知りたいときは、GetLastErrorを使います。ObjectDeleteの戻り値とは、意味が違います。
| 関数 | 戻り値の意味 |
|---|---|
| ObjectDelete | 命令を追加できたかどうか |
| ObjectsDeleteAll | 消したオブジェクトの数 |
※公式の説明から読み取れる内容を、筆者が整理しました。
細かい動きは、確認できなかった
ObjectDeleteで、存在しない名前を渡したときに、falseが返るかどうかは、確認したページに記載なしでした。名前の一致が、完全一致かどうかも、記載なしです。
ObjectsDeleteAllについても、記載なしの点があります。条件に合うものがないときに、0が返るかどうか、接頭辞の比較で大文字と小文字が区別されるかどうか、などです。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
接頭辞での指定には、どんな決まりがあるのか?
ここでは、ObjectsDeleteAllの接頭辞の使い方を整理します。EAの部品に、共通の名前の付け方をしておくと、まとめて消しやすくなります。
name と name* は、同じ動きになる
公式ページには、接頭辞は、nameとも、name*とも書けて、どちらも同じ動きになる、と書かれています。名前がその文字で始まるオブジェクトが、すべて対象です。
空の文字列を指定すると、どんな名前のオブジェクトも消える、とも書かれています。うっかり空のままにすると、全部が消えてしまうので、注意しましょう。
- nameとname*は同じ動き
- 名前がその文字で始まるものが対象
- 空の文字列はすべての名前が対象
公式のサンプルは、autotradeの部品を消している
公式のサンプルでは、接頭辞にautotradeを指定して、その名前で始まるオブジェクトを消しています。もう1つの書き方では、買いと売りの矢印の種類を指定して、すべて消しています。
コメントには、矢印の種類で消す場合は、自動売買のアイコン以外の矢印も消える、と書かれています。種類で消すときは、巻き込む範囲に気をつけましょう。
- 接頭辞で名前の始まりを指定する
- 種類で消すと他の矢印も消える
- 消した数は戻り値で分かる
消したあとは、ChartRedrawで反映する例がある
サンプルでは、消したあとに、ChartRedrawを呼んでいます。コメントには、変更をすぐに反映するため、と書かれています。ただし、ページの本文に、必ず必要という説明は、記載なしでした。
ChartRedrawのページには、ふつうは、オブジェクトのプロパティを変えたあとに使う、と書かれています。削除についての説明は、そのページにはありませんでした。
| ページ | ChartRedrawの扱い |
|---|---|
| ObjectsDeleteAll | サンプルで呼んでいる |
| ObjectDelete | サンプルでは呼んでいない |
| ChartRedraw | 削除については記載なし |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
EAが、チャートにラベルや矢印を表示している場合を考えます。1つは、特定のラベルだけを消したい場面です。もう1つは、EAを外すときに、自分が作った部品を全部消したい場面です。
- 特定のラベルだけ消したい
- EAを外すときに全部消したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
1つだけ消すなら、ObjectDeleteが分かりやすい
状態を表すラベルを、条件が変わったときに消したい場合は、ObjectDeleteが向いています。名前を指定するので、ほかの部品を巻き込む心配が少ないです。
ただし、非同期なので、消した直後にObjectFindで確かめると、待ち行列の分だけ時間がかかる場合があります。回数が多い処理では、この点に気をつけましょう。
- 名前を指定するので巻き込みにくい
- 戻り値は、命令を追加できたかどうか
- 確認の呼び出しは遅くなる場合がある
全部消すなら、ObjectsDeleteAllが手軽
EAを外すときに、自分の部品だけをまとめて消したいなら、ObjectsDeleteAllの接頭辞が向いています。部品の名前に、EAの名前を接頭辞として付けておく方法が考えられます。
OnDeinitの中で、接頭辞を指定して1回呼ぶだけで、まとめて消せます。後片付けの考え方は、IndicatorReleaseとOnDeinitの記事で整理しています。
| 場面(仮) | 向いている関数 |
|---|---|
| 特定のラベルだけ消す | ObjectDelete |
| EAを外すときに全部消す | ObjectsDeleteAll |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
1つずつ確実に消したいなら、ObjectDeleteを選ぶ
消したい部品が決まっているなら、ObjectDeleteが向いています。ラベルと文字の使い分けは、OBJ_LABELとOBJ_TEXTの記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
まとめて消したいなら、ObjectsDeleteAllを選ぶ
接頭辞や種類で、まとめて片付けたいなら、ObjectsDeleteAllが向いています。消した数が戻り値で分かるので、想定した数と合っているかも確かめやすいです。
- 接頭辞でまとめて消せる
- 消した数が戻り値で分かる
- 同期なので時間がかかる場合がある
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、いくつかのオブジェクトを作ってから、2つの関数で消してみましょう。消えた数と、画面の変わり方を、目で確かめると、違いがよく分かります。









もう1つのコツは、オブジェクトの名前に、EAの名前などの決まった接頭辞を付けておくことです。まとめて消すときに、自分の部品だけを狙いやすくなります。
また、名前は63文字までという決まりがあるので、接頭辞は短くしておくと扱いやすいです。この決まりは、ObjectCreateのページに書かれています。
さらに、ほかのEAや手作業で置いた部品を巻き込まないよう、種類だけで消す書き方は、慎重に使いましょう。公式のサンプルのコメントにも、ほかの矢印も消える、と書かれています。
- 接頭辞を決めて付ける
- 接頭辞は短くする
- 種類だけで消すときは巻き込みに注意
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ObjectDeleteで消えたかは、すぐ分かるのか?
いいえ。公式ページには、戻り値のtrueは、命令を追加できたという意味で、実行の結果は分からない、と書かれています。確かめたいときは、ObjectFindなどを使います。
- trueは命令を追加できた意味
- 結果の確認はObjectFindなど
削除のイベントは、どうなるのか?
チャートのイベントのページには、CHARTEVENT_OBJECT_DELETEは、グラフィカルオブジェクトが削除されたときのイベントで、チャートにCHART_EVENT_OBJECT_DELETEを設定したときに届く、と書かれています。
ただし、ObjectDeleteやObjectsDeleteAllが、このイベントを発生させるかどうかは、確認した関数のページに記載なしでした。
- 削除のイベントはCHARTEVENT_OBJECT_DELETE
- 設定が必要
- 関数との関係は記載なし
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のObjectDeleteとObjectsDeleteAll、名前を指定して1つずつ確実に消せる安心感と接頭辞でまとめて一気に消せる手軽さどっちを選ぶ?」
名前を指定して1つずつ消したいならObjectDelete、接頭辞や種類でまとめて消したいならObjectsDeleteAllが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










