この記事を開いてくださったこと、心から感謝しています。MQL5のEAでチャートの線や矢印を動かしたいとき、どの関数を使うか迷った人も多いはずです。
結論から言うと、アンカーポイントの時間と価格を1回でまとめて動かしたいならObjectMove、時間と価格を別々に設定したいならObjectSetIntegerとObjectSetDoubleが向いています。
ただし、一部の細かい動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、3つの関数の仕組み・動き方・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ObjectMoveとObjectSetInteger・ObjectSetDoubleは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、3つの関数の基本の違いを整理します。
ObjectMoveは、アンカーポイントを1回で動かす
MQL5公式リファレンスによると、ObjectMoveは、チャートのID、オブジェクトの名前、アンカーポイントの番号、時間、価格の5つを渡す関数です。選んだアンカーポイントの時間と価格を、まとめて指定します。
アンカーポイントの数は、オブジェクトの種類によって変わる、と書かれています。ただし、種類ごとの数は、確認したページに記載なしでした。
- 名前とアンカーポイントの番号を渡す
- 時間と価格を1回で指定する
- アンカーポイントの数は種類で変わる
ObjectSetIntegerとObjectSetDoubleは、プロパティを1つずつ設定する
時間のプロパティであるOBJPROP_TIMEは、整数系の設定を行うObjectSetIntegerで扱います。価格のプロパティであるOBJPROP_PRICEは、小数の設定を行うObjectSetDoubleで扱います。
どちらの関数にも、モディファイアを加えた書き方があります。プロパティの一覧のページには、OBJPROP_TIMEとOBJPROP_PRICEのモディファイアは、アンカーポイントの番号だと書かれています。
- OBJPROP_TIMEはObjectSetIntegerで設定する
- OBJPROP_PRICEはObjectSetDoubleで設定する
- モディファイアがアンカーポイントの番号になる
3つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ObjectMove | ObjectSetInteger・Double |
|---|---|---|
| 呼び出しの数 | 1回で時間と価格 | 時間と価格で2回 |
| アンカーポイントの指定 | 引数の番号 | モディファイアで指定 |
| 戻り値 | bool(命令を追加できたか) | bool(命令を送れたか) |
| 動き方 | 非同期 | 非同期 |
※公式の説明をもとにした、筆者の整理です。
3つに共通する動き方には、どんな決まりがあるのか?
次に、3つの関数に共通する動き方を見ていきます。ここを知っておくと、動かした直後の結果で慌てずに済みます。
どれも非同期で、戻り値は命令の結果になる
公式ページには、ObjectMoveは必ず非同期で呼ばれる、と書かれています。戻り値のtrueは、命令を待ち行列に追加できたという意味で、実行の結果は分かりません。
ObjectSetIntegerとObjectSetDoubleも、命令の実行を待たずに、すぐに制御を戻すと書かれています。失敗したときは、GetLastErrorで理由を調べます。
- 非同期で動く
- trueは命令を送れた意味
- 結果の確認はObjectGetXXXを使う
- 確認の呼び出しは時間がかかる場合がある
ChartRedrawで、見た目に反映させる
プロパティの一覧のページには、オブジェクトの作成や移動は、チャートにコマンドを送る仕組みで、すぐの見た目の更新は期待しないように、と書かれています。反映を強制したいときは、ChartRedrawを呼びます。
ObjectMoveのページ自体には、ChartRedrawの説明は、ありませんでした。ただし、サンプルの中では、変更のあとにChartRedrawを呼んでいます。
| ページ | ChartRedrawの扱い |
|---|---|
| プロパティ一覧 | すぐの更新は期待しないよう説明 |
| ObjectMoveのサンプル | 変更のあとに呼んでいる |
| ObjectSetDoubleのサンプル | 最後に呼んでいる |
※公式の説明から読み取れる内容を、筆者が整理しました。
細かい動きは、確認できなかった
範囲外のアンカーポイントの番号を渡したときの動きは、確認したページに記載なしでした。存在しない名前を渡したときの動きも、記載なしです。
ObjectMoveが、OBJPROP_TIMEとOBJPROP_PRICEを設定する2回の呼び出しと、まったく同じ動きなのかも、ページには書かれていませんでした。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どう書かれているのか?
ここでは、ObjectMoveのページにあるサンプルを見ていきます。実は、とても面白い書き方になっています。
ObjectMoveのサンプルは、ObjectMoveを呼んでいない
ObjectMoveのページのサンプルは、右向きと左向きの価格の矢印を作り、ティックのデータを再生して動かす内容です。動かすための補助の関数は、Moveという名前です。
ところが、このMoveの中身は、ObjectSetIntegerでOBJPROP_TIMEを、ObjectSetDoubleでOBJPROP_PRICEを設定する書き方です。ObjectMoveそのものは、呼ばれていません。
- 補助の関数の名前はMove
- 中身はObjectSetIntegerとObjectSetDouble
- ObjectMoveは呼ばれていない
変更のあとに、ChartRedrawを呼んでいる
サンプルでは、変更をまとめたあとに、ChartRedrawを呼んで画面を更新しています。終わったあとは、ObjectsDeleteAllで、サンプル用のオブジェクトを消しています。
消し方の違いは、ObjectDeleteとObjectsDeleteAllの記事で整理しています。
- 変更をまとめてからChartRedrawを呼ぶ
- 最後にObjectsDeleteAllで片付ける
ここから読み取れることと、読み取れないこと
公式のサンプルが、ObjectSetIntegerとObjectSetDoubleの組み合わせで書かれていることは、事実です。ただし、なぜその書き方なのかは、ページに記載なしでした。
そのため、ここでは、どちらが速いか、どちらが優れているかは、言えません。あくまで、公式のサンプルでは、こう書かれている、という整理です。
| 確認できること | 確認できないこと |
|---|---|
| サンプルはSetInteger・SetDoubleの組み合わせ | その書き方を選んだ理由 |
| 変更のあとにChartRedrawを呼ぶ | ObjectMoveとの速さの差 |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。
例の前提を、そろえる
チャートに置いた矢印を、新しい足ができるたびに、最新の位置へ動かす場合を考えます。時間と価格の両方が、毎回変わるとします。
- 矢印を最新の位置へ動かす
- 時間と価格が毎回変わる
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
ObjectMoveなら、1回の呼び出しで済む
時間と価格が、同時に変わる場面では、ObjectMoveが書きやすいです。名前と番号と、新しい時間と価格を渡すだけで、1行で済みます。
- 1行で書ける
- 時間と価格をセットで渡せる
- アンカーポイントの番号を引数で指定する
片方だけ変えるなら、個別の設定が向いている
価格だけを変えて、時間はそのままにしたい場面では、ObjectSetDoubleでOBJPROP_PRICEだけを設定する書き方が考えられます。変えたい項目だけを、狙って設定できるからです。
ラベルと文字の位置の使い分けは、OBJ_LABELとOBJ_TEXTの記事で整理しています。
| 場面(仮) | 向いている書き方 |
|---|---|
| 時間と価格を同時に動かす | ObjectMove |
| 価格だけ変える | ObjectSetDouble |
| 時間だけ変える | ObjectSetInteger |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
3つの特徴をふまえて、目的別の使い分けを考えます。
手軽さを優先するなら、ObjectMoveを選ぶ
時間と価格を、セットで動かすことが多いなら、ObjectMoveが向いています。呼び出しが1回で済むので、読みやすさの面でも、分かりやすいです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
細やかさを優先するなら、個別の設定を選ぶ
片方だけを変えたいときや、ほかのプロパティも続けて設定したいときは、ObjectSetIntegerとObjectSetDoubleが向いています。公式のサンプルも、この書き方でした。
- 片方だけ変えたい
- ほかのプロパティも続けて設定したい
- 公式のサンプルと同じ書き方になる
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、矢印を1つ作って動かしてみましょう。ObjectMoveと、個別の設定の両方で動かして、見た目を確かめると、違いがよく分かります。









もう1つのコツは、オブジェクトを動かす処理を、1つの関数にまとめておくことです。あとから、ObjectMoveと個別の設定を入れ替えたくなったときも、直す場所が1か所で済みます。
また、動かした結果を確かめたいときは、ObjectGetIntegerやObjectGetDoubleを使います。公式ページには、これらは待ち行列の最後に入り、時間がかかる場合がある、と書かれています。
- 動かす処理を1つの関数にまとめる
- 変更をまとめてからChartRedrawを呼ぶ
- 確認の呼び出しは回数を絞る
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ObjectMoveで動かしたら、すぐ位置が変わるのか?
すぐとは限りません。公式ページには、戻り値のtrueは、命令を追加できたという意味で、実行の結果は分からない、と書かれています。
- trueは命令を追加できた意味
- 結果の確認はObjectGetXXX
アンカーポイントは、いくつあるのか?
オブジェクトの種類によって変わる、と書かれています。種類ごとの数は、確認したページに記載なしでした。使う種類のページで、確かめましょう。
- 数は種類によって変わる
- 種類ごとの数は記載なし
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のObjectMoveとObjectSetInteger・ObjectSetDouble、時間と価格を1回で動かせる手軽さと時間と価格を別々に決められる細やかさどっちを選ぶ?」
時間と価格を同時に動かすならObjectMove、片方だけ変えたり続けて設定したりするならObjectSetIntegerとObjectSetDoubleが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










