この記事を開いてくださったこと、心から感謝しています。プログラムからチャートを開いたり閉じたりしたいと考えて、調べている人も多いはずです。
結論から言うと、新しいチャートを開いてそのIDを受け取りたいならChartOpen、開いたチャートを閉じたいならChartCloseです。2つは対になる関数で、組み合わせて使うのが基本になります。
ただし、失敗する原因や、存在しないIDを閉じたときの扱いなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartOpenとChartCloseは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。一言でいえば、開く関数と閉じる関数です。
ChartOpenは、新しいチャートを開く
MQL5公式リファレンスによると、ChartOpenは、指定した通貨ペアと時間足で新しいチャートを開く関数です。戻り値はlong型で、成功すると開いたチャートのIDを返します。
引数は2つあります。1つ目は通貨ペア名で、NULLを指定すると現在のチャートの通貨ペアになります。2つ目は時間足で、0を指定すると現在のチャートの時間足になります。
- 新しいチャートを開く
- 成功すると、チャートIDを返す
- 失敗すると、0を返す
ChartCloseは、チャートを閉じる
ChartCloseは、指定したチャートを閉じる関数です。引数はチャートIDの1つだけで、0を指定すると現在のチャートを閉じます。省略したときの初期値も0と書かれています。
戻り値はbool型です。成功すればtrue、失敗すればfalseが返ります。ChartOpenが返したIDを、そのまま渡せる形になっています。
- 指定したチャートを閉じる
- 引数のIDが0なら、現在のチャート
- 戻り値はbool型
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartOpen | ChartClose |
|---|---|---|
| 役割 | チャートを開く | チャートを閉じる |
| 引数 | 通貨ペア名と時間足 | チャートID(初期値0) |
| 戻り値 | long型のチャートID | bool型の成否 |
| 失敗時 | 0を返す | falseを返す |
| 失敗の原因 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ChartOpenの引数と戻り値は、どう読めばよいのか?
ここでは、ChartOpenを使うときに押さえておきたい点を、公式の説明から整理します。短いページですが、気をつけたい一文があります。
NULLと0は、現在のチャートを意味する
通貨ペアにNULLを渡すと、現在のチャートの通貨ペアが使われます。時間足に0を渡すと、現在のチャートの時間足が使われます。同じ設定でもう1つ開きたいときに便利です。
公式のサンプルでは、NULLのときにSymbol関数で通貨ペアを補い、時間足が現在のものを指すときにはPeriod関数で補っています。値を明示してから渡す書き方です。
- 通貨ペアがNULLなら、現在の通貨ペア
- 時間足が0なら、現在の時間足
- 明示してから渡す書き方もある
同時に開けるチャートの数には、上限がある
公式ページには、端末で同時に開けるチャートの最大数は、CHARTS_MAXの値を超えられない、という注意書きがあります。ただし、CHARTS_MAXの具体的な数字は、このページには記載なしでした。
そのため、たくさんのチャートを繰り返し開くプログラムでは、不要になったチャートを閉じる処理も用意しておくと安心です。ここで、ChartCloseの出番になります。
| 確認できること | 確認できないこと |
|---|---|
| 戻り値は成功時にチャートID | CHARTS_MAXの具体的な数字 |
| 失敗時は0 | 失敗の具体的な原因 |
| 上限があることは明記されている | 存在しない通貨ペアを渡したときの扱い |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
ChartCloseの引数と戻り値は、どう読めばよいのか?
次に、ChartCloseの側を見ていきます。こちらはさらに短いページで、注意書きの欄もありませんでした。
引数のチャートIDは、省略できる
シグネチャは、チャートIDの初期値が0になっています。つまり、引数なしで呼び出せて、その場合は現在のチャートが対象です。
EAの中で引数なしのChartCloseを呼ぶと何が起きるかは、確認した公式ページには記載なしでした。現在のチャートの扱いは、自分の環境で確かめる必要があります。
- チャートIDの初期値は0
- 0は現在のチャートを意味する
- EAからの呼び出しの影響は記載なし
戻り値がfalseのときの扱いは、書かれていない
戻り値は、成功ならtrue、失敗ならfalseです。ただし、存在しないIDや、すでに閉じたIDを渡したときにどうなるかは、記載なしでした。
公式のサンプルでは、失敗したときにGetLastErrorでエラーコードを表示しています。ただ、どんなコードが返るのかは、ページには書かれていません。
- 成功ならtrue
- 失敗ならfalse
- 無効なIDの扱いは記載なし
公式のサンプルは、どう書かれているのか?
2つの公式サンプルは、つながった流れになっています。開いてから、少し待って、閉じる、という順番です。
ChartOpenのサンプルは、開いて結果を表示する
ChartOpenのサンプルは、開いたあとに戻り値が0かどうかを確かめます。0なら、失敗とエラーコードを表示して終わります。成功なら、通貨ペアと時間足とIDを表示します。
コメントに書かれた出力例では、GBPUSDのM1で開いたチャートと、18桁ほどの長いIDが示されています。このIDは例なので、実際の値は環境で変わります。
- 戻り値が0なら、失敗として終了する
- 成功なら、通貨ペアと時間足とIDを表示する
- 出力例のIDは例であり、毎回変わる
ChartCloseのサンプルは、開いて3秒待って閉じる
ChartCloseのサンプルは、まずChartOpenで新しいチャートを開きます。次に、3秒待つというメッセージを表示して、Sleep関数で3000ミリ秒待ちます。
その後、ChartCloseに開いたチャートのIDを渡して閉じます。失敗したときはエラーコードを、成功したときは、閉じられたことを表示します。
この3秒の待機が、動作に必須なのかどうかは、記載なしでした。人が見て分かりやすいように入れている、と読むのが自然ですが、公式にはそう書かれていません。
| 手順 | やっていること |
|---|---|
| 1 | ChartOpenで新しいチャートを開く |
| 2 | IDと設定を表示する |
| 3 | Sleepで3秒待つ |
| 4 | ChartCloseにIDを渡して閉じる |
| 5 | 成功か失敗かを表示する |
※公式のサンプルの流れを、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
複数の時間足のチャートを順番に開いて、確認し終わったら閉じたい場合を考えます。
- 時間足ごとにチャートを1つずつ開く
- 確認が終わったら、自動で閉じる
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
開く側と閉じる側で、役割が分かれる
開く側では、ChartOpenを呼んで、戻り値のIDを変数に保存します。このIDが、あとの操作すべての手がかりになるため、保存し忘れないことが大切です。
閉じる側では、保存しておいたIDをChartCloseに渡します。IDを持っていれば、どのチャートでも指定して閉じられます。
- 開いたらすぐIDを保存する
- IDを使って、あとで閉じる
- IDを失うと、指定して閉じられない
開いた直後の操作は、別の関数で行う
開いたチャートにインジケーターを追加したい場合は、別の関数を使います。その考え方は、ChartIndicatorAddとChartIndicatorDeleteの記事で整理しています。
| 場面(仮) | 向いている関数 |
|---|---|
| 新しいチャートを開く | ChartOpen |
| 不要なチャートを閉じる | ChartClose |
| 開いたチャートに指標を足す | ChartIndicatorAdd |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つは競合する関数ではなく、対になる関数です。そのため、どちらかを選ぶというより、場面ごとにどちらを呼ぶかを決めることになります。
チャートを増やしたいなら、ChartOpenを選ぶ
別の通貨ペアや別の時間足を、画面に追加したいときは、ChartOpenを使います。戻り値のIDを保存しておけば、あとからそのチャートを操作できます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
チャートを減らしたいなら、ChartCloseを選ぶ
役目を終えたチャートを閉じたいときは、ChartCloseを使います。開けるチャートの数には上限があるため、閉じる処理を用意しておくと安心です。
チャートの表示位置を動かしたい場合は、ChartNavigateとChartSetIntegerの記事が参考になります。開く、動かす、閉じるの流れで考えると理解しやすくなります。
- 役目を終えたチャートを閉じたい
- 開けるチャート数の上限に備えたい
- IDを指定して、特定のチャートを閉じたい
小さく試して、動きを確かめる
いきなり複雑な処理を作らず、公式サンプルのように、1つ開いて少し待ってから閉じるところから始めましょう。









もう1つのコツは、戻り値を必ず確認することです。公式のサンプルも、0やfalseのときにエラーコードを表示する書き方になっています。
- ChartOpenの戻り値が0か確かめる
- ChartCloseの戻り値がfalseか確かめる
- 失敗時はGetLastErrorで調べる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
チャートは、いくつまで開けるのか?
公式ページには、CHARTS_MAXの値を超えられない、と書かれています。ただし、その具体的な数字は、確認したページには記載なしでした。
- 上限はCHARTS_MAXで決まる
- 具体的な数字は記載なし
引数なしのChartCloseは、何を閉じるのか?
チャートIDの初期値は0で、0は現在のチャートを意味します。そのため、引数なしでは現在のチャートが対象になります。EAからの呼び出しの影響は、記載なしです。
- 引数なしは、現在のチャートが対象
- EAからの影響は記載なし
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartOpenとChartClose、新しいチャートを開いてIDを受け取れる便利さと不要になったチャートを閉じて整理できる手軽さどっちを選ぶ?」
新しいチャートを開いてIDを受け取るならChartOpen、開いたチャートを閉じるならChartCloseです。対にして使い、記載のない点は自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










