この記事を開いてくださったこと、心から感謝しています。チャートの表示をプログラムから動かしたり、更新したりしたいと考えている人も、きっと多いはずです。
結論から言うと、チャートを狙った位置まで動かしたいならChartNavigate、変更した内容を今すぐ画面に反映したいならChartRedrawです。動かす関数と、描き直す関数という違いがあります。
また、同期か非同期かなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartNavigateとChartRedrawは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはチャートの表示位置を動かす関数で、もう1つは強制的に描き直す関数です。
ChartNavigateは、チャートを指定の位置へ動かす
ChartNavigateは、チャートをスクロールして、指定した位置へ動かす関数です。引数は、チャートID、基準となる位置、動かす本数の3つで、動かす本数は省略できます。
戻り値はbool型で、成功するとtrue、失敗するとfalseです。チャートIDの0は、現在のチャートを意味します。エラーコードについては、確認したページには記載なしでした。
- チャートを、指定した位置へスクロールする
- 引数は、チャートID・基準の位置・動かす本数
- 戻り値は、成功ならtrue、失敗ならfalse
ChartRedrawは、チャートを強制的に描き直す
ChartRedrawは、指定したチャートを、強制的に再描画する関数です。引数はチャートIDだけで、省略すると0、つまり現在のチャートが対象になります。
戻り値はありません。公式の注意書きには、通常は、オブジェクトのプロパティを変更したあとに使う、と書かれています。失敗を知らせる仕組みは、記載なしでした。
- チャートを、強制的に描き直す
- 引数は、チャートIDだけ(省略すると0)
- 戻り値は、ない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartNavigate | ChartRedraw |
|---|---|---|
| 役割 | チャートを指定の位置へ動かす | チャートを強制的に描き直す |
| 戻り値 | bool | なし(void) |
| 引数 | チャートID・位置・本数 | チャートID(省略可) |
| 失敗の知らせ方 | falseを返す | 記載なし |
| 同期か非同期か | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ChartNavigateは、どんな場面で使うのか?
ChartNavigateは、過去のほうへ戻ったり、最新のほうへ進んだりするときの、基本の関数です。基準の位置と本数の決まりを、公式の説明から確認しましょう。
基準の位置は、3つの中から選ぶ
基準の位置には、ENUM_CHART_POSITIONの値を渡します。公式の説明では、チャートの先頭、現在の位置、チャートの末尾の3つが挙げられています。
先頭は、いちばん古い価格のほうを意味し、末尾は、いちばん新しい価格のほうを意味します。現在の位置については、詳しい説明が、確認したページにはありませんでした。
| 値 | 意味 |
|---|---|
| CHART_BEGIN | チャートの先頭(いちばん古い価格) |
| CHART_CURRENT_POS | 現在の位置 |
| CHART_END | チャートの末尾(いちばん新しい価格) |
※公式の説明をもとにした、筆者の整理です。
動かす本数は、プラスで右、マイナスで左
動かす本数が正の値なら、右へ、つまりチャートの末尾の方向へ動きます。負の値なら、左へ、つまり先頭の方向へ動く、と書かれています。0なら、先頭や末尾へ移動できます。
現在の位置を基準にしたときの本数の意味は、公式の説明に明記がなく、記載なしでした。動かし方を確かめるときは、自分の環境で試すのが安心です。
- プラスの値は、右(末尾の方向)へ動かす
- マイナスの値は、左(先頭の方向)へ動かす
- 0は、先頭や末尾へ移動できる
公式のもう1つの例は、末尾へ動かして描き直す
位置の定数を説明するページには、別の例もあります。ChartOpenでEURUSDの12時間足を開き、ChartNavigateで、末尾から150本の位置へ動かします。
動かす前にResetLastErrorを呼び、失敗したときはGetLastErrorの値を表示します。最後にChartRedrawを呼ぶ流れで、2つの関数が、実際に並んで使われています。
- 12時間足のチャートを、先に開いておく
- 動かす前に、エラーの値をリセットする
- 動かしたあとに、ChartRedrawで描き直す
ChartRedrawは、どんな場面で使うのか?
ChartRedrawは、とても短い関数ですが、見た目をすぐ反映したいときに役立ちます。公式の説明から、使う場面を確認します。
オブジェクトを変更したあとに、反映する
公式の説明では、通常は、オブジェクトのプロパティを変更したあとに使うと書かれています。変更した内容を、次の更新を待たずに、画面へ反映したいときの使い方です。
オブジェクトを動かしたり、設定を変えたりする関数は、ObjectMoveとObjectSetIntegerの記事で整理しています。変更のあとに描き直す、という組み合わせです。
- オブジェクトの変更を、すぐ反映したい
- 次の更新を待たずに、画面を更新したい
- 対象のチャートを、IDで指定できる
対象のチャートは、IDで指定する
ChartRedrawは、チャートIDを渡すと、そのチャートを描き直せます。省略したときは、プログラムが動いている現在のチャートが対象になります。
- IDを渡すと、そのチャートを描き直せる
- 省略すると、現在のチャートが対象になる
- 公式サンプルは、省略した形で呼んでいる
同期か非同期かは、記載なし
描き直しの処理が、呼び出しの時点で終わるのか、あとから実行されるのかについては、確認したページには記載なしでした。性能や使う回数の制限も、書かれていません。
そのため、短い時間に何度も呼び出すときは、自分の環境で動きを確かめてから使うのが安全です。公式サンプルでは、色を変えるたびに、1回ずつ呼んでいます。
| 確認した点 | 公式の記載 |
|---|---|
| 通常の使い方 | オブジェクトのプロパティ変更のあと |
| 戻り値 | なし |
| 同期か非同期か | 記載なし |
| 回数などの制限 | 記載なし |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どう書かれているのか?
2つの関数には、それぞれ公式サンプルがあります。どちらも、動きの流れが分かりやすい、短いスクリプトです。
ChartNavigateは、先頭と末尾を行き来する
ChartNavigateのサンプルは、先に、自動スクロールを切り、チャートの右端の余白を有効にして、ローソク足の表示にします。そのあと、5秒ごとに動かします。
動かし方は、先頭から10本右、末尾から10本左、先頭から300本右、末尾から300本左の順です。動かすたびに、最初に見えている足の番号を表示します。
ただし、このサンプルは、戻り値を確認していません。出力の具体的な数値も、確認したページには記載なしでした。画像として残したいときの使い方は、ChartScreenShotとChartSaveTemplateの記事が参考になります。
- 自動スクロールを切ってから、動かす
- 5秒ごとに、位置を切り替える
- 動かすたびに、最初に見える足の番号を表示する
ChartRedrawは、長方形の色を変えて描き直す
ChartRedrawのサンプルは、直近の50本を囲む長方形を描き、その色を、1秒ごとに変えていきます。色を変えるたびに、ChartRedrawを呼び出しています。
色は、ドジャーブルー、ライムグリーン、オレンジレッドの順に変わり、最後に元の色へ戻ります。そのあと3秒待って、長方形を削除する流れです。
| サンプル | 主な流れ |
|---|---|
| ChartNavigate | 先頭と末尾を、本数を変えながら行き来する |
| ChartRedraw | 長方形の色を変え、そのたびに描き直す |
※公式サンプルの内容を、筆者が整理しました。
どう使い分ければよいのか?
2つは競合する関数ではなく、役割が違います。位置を動かすのか、反映を急ぐのかで、使い分けます。
位置を動かすなら、ChartNavigateを選ぶ
チャートを、過去のほうや最新のほうへ動かしたいときは、ChartNavigateが向いています。基準の位置と本数で、狙った場所へ動かせるのが特長です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
反映を急ぐなら、ChartRedrawを選ぶ
オブジェクトを変更したあとなど、見た目をすぐ更新したいときは、ChartRedrawが向いています。引数が1つだけで、手軽に呼べるのが特長です。
- 変更した内容を、すぐ反映したい
- 引数なしでも、現在のチャートに使える
- 戻り値の確認は、必要ない
組み合わせるなら、動かしてから描き直す
公式の例には、チャートを動かしたあとに、ChartRedrawを呼ぶ書き方もあります。動かして、描き直す、という流れは、見た目を確実に整えたいときの1つの形です。









もう1つのコツは、ChartNavigateの戻り値を確認することです。公式のサンプルは確認していないので、自分で書くときは、falseのときにGetLastErrorで調べる形にしましょう。
- falseのときの処理を、先に決めておく
- 本数の向きは、小さな値で試して確かめる
- 結果は、まずログに出して確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ChartRedrawは、毎回呼ぶ必要があるのか?
公式の説明では、通常は、オブジェクトのプロパティを変更したあとに使う、と書かれています。毎回必要かどうかは、確認したページには記載なしでした。
- 通常は、オブジェクト変更のあとに使う
- 毎回必要かどうかは、記載なし
ChartNavigateの本数に、負の値を渡してもよいのか?
公式の説明では、負の値は、左へ、つまりチャートの先頭の方向へ動かす意味になります。公式サンプルにも、末尾から10本左へ動かす例があります。
- 負の値は、左へ動かす
- 正の値は、右へ動かす
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartNavigateとChartRedraw、チャートを狙った位置まで動かせる便利さと変更した内容を今すぐ描き直して反映できる手軽さどっちを選ぶ?」
チャートを狙った位置まで動かしたいならChartNavigate、変更した内容を今すぐ反映したいならChartRedrawです。記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










