この記事を開いてくださったこと、心から感謝しています。MQL5でチャートの表示位置を動かしたいとき、どの関数を使うか迷った人も多いはずです。
結論から言うと、指定した足数だけ表示位置を動かしたいならChartNavigate、表示の動き方そのものを設定したいならChartSetIntegerが向いています。
ただし、一部の細かい動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、関数の仕組み・動き方・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartNavigateとChartSetIntegerは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。
ChartNavigateは、基準の位置から足数だけ動かす
MQL5公式リファレンスによると、ChartNavigateは、指定したチャートを、指定した位置を基準にして、指定した足数だけ動かす関数です。チャートのID、基準の位置、足数の3つを渡します。
足数が正の値なら右(チャートの終わり側)へ、負の値なら左(始まり側)へ動きます。足数を0にすると、始まりや終わりへ移動できる、と書かれています。
- チャートのID・基準の位置・足数を渡す
- 正の値は右、負の値は左へ動く
- 足数0で始まりや終わりへ移動できる
ChartSetIntegerは、動き方の設定を変える
ChartSetIntegerは、チャートのプロパティを1つずつ設定する関数です。公式のサンプルでは、自動スクロールのオフや、右端の余白のオンなどに使われています。
種類や動き方の詳細は、ChartSetIntegerとChartSetDoubleの記事で整理しています。
- プロパティを1つずつ設定する
- 自動スクロールや余白の設定に使われる
- 位置を動かす関数ではない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartNavigate | ChartSetInteger |
|---|---|---|
| 役割 | 表示位置を動かす | 動き方の設定を変える |
| 渡すもの | ID・基準・足数 | ID・プロパティ・値 |
| 戻り値 | bool(成功したか) | bool(命令を送れたか) |
| 動き方 | 同期か非同期かは記載なし | 非同期 |
※公式の説明をもとにした、筆者の整理です。
ChartNavigateには、どんな決まりがあるのか?
次に、ChartNavigateの決まりを見ていきます。基準の位置の選び方が、使い方のポイントです。
基準の位置と足数で、動く先が決まる
基準の位置には、ENUM_CHART_POSITIONの値を使います。公式のサンプルで使われているのは、始まりを表すCHART_BEGINと、終わりを表すCHART_ENDです。
たとえば、サンプルでは、始まりから10本ぶん動かす呼び出しと、終わりから逆向きに10本ぶん動かす呼び出しを使っています。
| 呼び出し | 意味 |
|---|---|
| CHART_BEGINと10 | 始まりを基準に10本ぶん動かす |
| CHART_ENDと-10 | 終わりを基準に左へ10本ぶん動かす |
| CHART_BEGINと300 | 始まりを基準に300本ぶん動かす |
| CHART_ENDと-300 | 終わりを基準に左へ300本ぶん動かす |
※公式のサンプルの呼び出しを、筆者が整理しました。
サンプルは、動かす前に設定を整えている
サンプルでは、動かす前に、ChartSetIntegerで自動スクロールをオフにして、右端の余白をオンにしています。ローソク足の表示や、ティックの出来高の表示も設定しています。
そのあと、ChartNavigateで動かし、ChartGetIntegerで、最初に見えている足の番号を読み取って、表示しています。
- 自動スクロールをオフにする
- 右端の余白をオンにする
- 動かしたあと、最初に見える足の番号を読む
細かい動きは、確認できなかった
同期で動くのか非同期で動くのかは、確認したページに記載なしでした。履歴の範囲を超える足数を渡したときの動きも、記載なしです。
無効なチャートIDを渡したときの動きや、使える場所の制限も、ページには書かれていませんでした。サンプルは、戻り値を確認していません。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どんな順番で動かしているのか?
ここでは、ChartNavigateのページにあるサンプルを、順番に追っていきます。使い方の流れをつかむのに役立ちます。
まず、チャートのIDを確かめて設定を整える
サンプルは、ChartIDで現在のチャートのIDを取り、その値が0より大きいときだけ、続きの処理に進みます。IDが取れなかったときは、何も動かしません。
そのあと、ChartSetIntegerで、自動スクロールのオフ、右端の余白のオン、ローソク足の表示、ティックの出来高の表示を、順に設定しています。
- ChartIDでIDを取る
- IDが0より大きいときだけ進む
- 表示の設定を先にまとめて整える
次に、4回動かして、位置を読み取る
設定のあと、始まりから10本、終わりから逆向きに10本、始まりから300本、終わりから逆向きに300本の順に、ChartNavigateを呼んでいます。
最初の2回は、動かした直後に、ChartGetIntegerで最初に見えている足の番号を読み取り、Commentで画面に表示しています。
| 順番 | 呼び出し | 位置の読み取り |
|---|---|---|
| 1回目 | CHART_BEGINと10 | 読み取って表示 |
| 2回目 | CHART_ENDと-10 | 読み取って表示 |
| 3回目 | CHART_BEGINと300 | サンプルに記載なし |
| 4回目 | CHART_ENDと-300 | サンプルに記載なし |
※公式のサンプルの流れを、筆者が整理しました。
各ステップのあとに、5秒待っている
サンプルでは、各ステップのあとにSleepで5秒待っています。動きを目で見て確かめられるようにするためだと考えられますが、理由はページに記載なしでした。
同じ書き方を、本番のEAにそのまま使うかどうかは、自分の目的に合わせて決めましょう。待つ処理は、ほかの処理を止める点にも気をつけたいところです。
- 各ステップのあとに5秒待つ
- 理由はページに記載なし
- 本番では待つ処理の影響を考える
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。
例の前提を、そろえる
過去のローソク足を見直すために、チャートを300本ぶん左へ動かしたい場合と、新しい足が来ても表示位置を動かしたくない場合を考えます。
- 300本ぶん左へ動かしたい
- 新しい足が来ても位置を変えたくない
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
位置を動かすなら、ChartNavigateが分かりやすい
決まった足数だけ動かしたいなら、ChartNavigateが分かりやすいです。基準の位置と足数を渡すだけで、動かしたい量を、そのまま書けます。
- 動かす量を数字で書ける
- 始まりや終わりを基準にできる
- サンプルと同じ形で試せる
動き方を決めるなら、ChartSetIntegerを使う
新しい足が来ても位置を動かしたくないなら、自動スクロールをオフにする設定が考えられます。サンプルでも、動かす前にオフにしていました。
| 場面(仮) | 向いている書き方 |
|---|---|
| 300本ぶん左へ動かす | ChartNavigate |
| 自動スクロールを止める | ChartSetInteger |
| 両方を組み合わせる | サンプルと同じ流れ |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
分かりやすさを優先するなら、ChartNavigateを選ぶ
表示位置を、決まった足数だけ動かしたいときは、ChartNavigateが向いています。動かす量を、そのまま書けるからです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
柔軟さを優先するなら、ChartSetIntegerを選ぶ
自動スクロールや余白など、表示の動き方を決めたいときは、ChartSetIntegerが向いています。位置を動かす前の準備にも使えます。
テンプレートを使った見た目の整え方は、ChartApplyTemplateとChartSetIntegerの記事で整理しています。
- 自動スクロールを設定したい
- 右端の余白を設定したい
- 動かす前の準備をしたい
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、足数を変えながら動かしてみましょう。動かしたあとの、最初に見える足の番号を表示すると、変化がよく分かります。









もう1つのコツは、動かす処理を、1つの関数にまとめておくことです。あとから、基準の位置や足数を変えたくなったときも、直す場所が1か所で済みます。
また、動かしたあとに、最初に見える足の番号を読み取って、ログに残しておくと、意図した位置へ動いたかを、あとから見直せます。
- 動かす処理を1つにまとめる
- 動かした結果をログに残す
- 戻り値を確認する習慣をつける
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
足数の正と負は、どちらが右なのか?
公式ページによると、正の値は右へ、負の値は左へ動かします。足数を0にすると、始まりや終わりへ移動できます。
- 正の値は右へ動く
- 負の値は左へ動く
基準の位置には、何を指定するのか?
ENUM_CHART_POSITIONの値を指定します。サンプルで使われているのは、CHART_BEGINとCHART_ENDの2つです。全部の値は、今回確認したページには載っていませんでした。
- ENUM_CHART_POSITIONの値を使う
- サンプルはBEGINとENDを使用
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartNavigateとChartSetInteger、指定した足数だけ表示位置を動かせる分かりやすさと自動スクロールなど動き方の設定を決められる柔軟さどっちを選ぶ?」
決まった足数だけ位置を動かすならChartNavigate、自動スクロールなど動き方を決めるならChartSetIntegerが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










