この記事を開いてくださったこと、心から感謝しています。チャートのサブウィンドウの番号を調べたいと考えている人も、きっと多いはずです。
結論から言うと、指標の名前からサブウィンドウ番号を探したいならChartWindowFind、ドロップした先の番号をすぐ知りたいならChartWindowOnDroppedです。どちらも番号を返しますが、調べる相手と使える場面が違います。
また、エラーコードのように、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartWindowFindとChartWindowOnDroppedは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも、サブウィンドウの番号を返す点は共通しています。
ChartWindowFindは、指標の短縮名から番号を探す
ChartWindowFindは、指標の短縮名を手がかりに、その指標が動いているサブウィンドウの番号を返す関数です。引数はチャートIDと短縮名の2つで、戻り値はint型です。
チャートIDの0は、現在のチャートを意味します。失敗したときは、-1を返すと書かれています。エラーコードについては、確認したページには記載なしでした。
- 指標の短縮名から、サブウィンドウの番号を探す
- 引数は、チャートIDと短縮名の2つ
- 失敗したときは、-1を返す
ChartWindowOnDroppedは、ドロップした先の番号を返す
ChartWindowOnDroppedは、エキスパートアドバイザーやスクリプトをドロップした先の、サブウィンドウの番号を返す関数です。引数はなく、0はメインのチャートウィンドウを意味します。
戻り値はint型です。失敗したときの値や、返る番号の範囲については、確認したページには記載なしでした。注意書きの欄もありませんでした。
- ドロップした先のサブウィンドウの番号を返す
- 引数はない
- 0は、メインのチャートウィンドウ
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartWindowFind | ChartWindowOnDropped |
|---|---|---|
| 調べる相手 | 短縮名で指定した指標 | ドロップしたプログラム |
| 引数 | チャートIDと短縮名(引数なしの形もある) | なし |
| 戻り値の型 | int | int |
| 失敗時の値 | -1 | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ChartWindowFindは、どんな場面で使うのか?
ChartWindowFindには、引数ありの形と、引数なしの形があります。どちらも、指標がどのサブウィンドウにいるかを調べる関数です。
短縮名は、ファイル名とは別のもの
公式ページには、短縮名とファイル名を混同しないよう注意する説明があります。ファイル名はiCustomやIndicatorCreateで使い、短縮名はこの関数で使う、という違いです。
短縮名を指定していない場合は、コンパイル時のソースファイル名が使われる、とも書かれています。短縮名は、IndicatorSetStringで、INDICATOR_SHORTNAMEに設定します。
- ファイル名は、iCustomやIndicatorCreateで使う
- 短縮名は、IndicatorSetStringで設定する
- 未設定なら、ソースファイル名が使われる
短縮名に、入力パラメータの値を入れておくとよい
公式ページでは、短縮名に、指標の入力パラメータの値を含めることを勧めています。理由は、ChartIndicatorDeleteが、短縮名で指標を見分けるためです。
この関数の使い方は、ChartIndicatorAddとChartIndicatorDeleteの記事で整理しています。短縮名が重ならないように決めておくと、狙った指標を探しやすくなります。
| 短縮名の例 | 読み取れること |
|---|---|
| MACD(12,26,9) | 公式サンプルの入力値の例 |
| RSI(14) | 期間まで短縮名に入れた書き方の例 |
※短縮名の例は、公式サンプルと、筆者が考えた書き方の例です。
引数なしの形は、指標の中から呼ぶ
引数なしのChartWindowFindは、カスタム指標の中から呼び出す必要があり、その指標が動いているサブウィンドウの番号を返します。
スクリプトやエキスパートアドバイザーから引数なしで呼び出すと、-1が返る、と書かれています。呼び出す場所によって、結果が変わる点に注意が必要です。
- 引数なしの形は、カスタム指標の中から呼ぶ
- スクリプトやエキスパートアドバイザーからは-1が返る
- 引数ありの形は、チャートIDと短縮名で探す
ChartWindowOnDroppedは、どんな場面で使うのか?
ChartWindowOnDroppedは、とても短い関数です。ドロップした場所の情報を受け取るときの、入口になります。
ドロップした場所の番号を、そのまま受け取る
スクリプトやエキスパートアドバイザーを、チャート上にドロップすると、どのウィンドウに落としたかが分かります。メインのチャートなら0、サブウィンドウなら、その番号が返ります。
ドロップした位置の時間や価格を知りたいときは、ChartTimeOnDroppedとChartPriceOnDroppedの記事も参考になります。位置の情報は、いくつかの関数に分かれています。
- メインのチャートなら、0が返る
- サブウィンドウなら、その番号が返る
- 位置の情報は、ほかの関数で受け取る
公式サンプルは、ウィンドウの総数と並べて表示する
公式サンプルは、ChartWindowOnDroppedで番号を取り、ChartGetIntegerのCHART_WINDOWS_TOTALで、ウィンドウの総数も取ります。そのあと、2つの値をまとめて表示します。
表示には、ChartSymbolで取った通貨ペア名も添えられています。ただし、サンプルの出力例は、確認したページには記載なしでした。
| サンプルで使う関数 | 役割 |
|---|---|
| ChartWindowOnDropped | ドロップした先の番号を取る |
| ChartGetInteger | ウィンドウの総数を取る |
| ChartSymbol | 通貨ペア名を取る |
※公式サンプルの内容を、筆者が整理しました。
公式のサンプルは、どう書かれているのか?
ChartWindowFindの公式サンプルは、スクリプトの形で書かれています。短縮名を入力して、その指標がどのウィンドウにあるかを表示する内容です。
入力した短縮名で、指標のウィンドウ番号を探す
サンプルは、入力パラメータで、短縮名の初期値をMACD(12,26,9)にしています。GetIndicatorSubWindowNumberという関数を作り、その中でChartWindowFindを使います。
実行するプログラムの種類が指標なら、引数なしの形を呼びます。それ以外は、チャートIDと短縮名を渡す形で呼ぶ、という分け方です。
- 短縮名の初期値は、MACD(12,26,9)
- 指標なら、引数なしの形を呼ぶ
- それ以外は、チャートIDと短縮名を渡す
結果が-1のときは、エラーの内容を表示する
引数ありの形で、結果が-1のときは、GetLastErrorで取ったエラーの値を表示します。見つかったときは、指標の名前とウィンドウ番号を、画面に出します。
見つからなかったときも、短縮名と-1を並べたメッセージが出ます。戻り値をきちんと確認する書き方なので、そのまま真似しやすい形です。
| 結果 | サンプルの動き |
|---|---|
| 見つかった | 指標の名前とウィンドウ番号を表示する |
| 見つからない | 短縮名と、-1を表示する |
| 引数ありで-1 | GetLastErrorの値も表示する |
※公式サンプルの内容を、筆者が整理しました。出力例は記載なしです。
どう使い分ければよいのか?
2つは競合する関数ではなく、調べる相手が違います。指標を探すのか、ドロップした先を知るのかで、使い分けます。
指標の場所を探すなら、ChartWindowFindを選ぶ
すでにチャートに載っている指標が、どのサブウィンドウにあるかを調べたいときは、ChartWindowFindが向いています。短縮名で、狙って探せるのが特長です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
ドロップした先を知るなら、ChartWindowOnDroppedを選ぶ
スクリプトやエキスパートアドバイザーを、ドロップした先のウィンドウを知りたいときは、ChartWindowOnDroppedが向いています。引数がなく、呼ぶだけで済むのが特長です。
- ドロップした先のウィンドウ番号を知りたい
- 引数なしで、手軽に呼びたい
- メインのチャートかどうかを、0で判断したい
組み合わせるなら、番号を先に受け取る
ドロップした先の番号を先に受け取り、その番号を使って、ほかの処理に進む組み立ても考えられます。ただし、こうした組み合わせの公式サンプルは、確認したページには記載なしでした。









もう1つのコツは、短縮名を決めるときに、ほかの指標と重ならない名前にすることです。名前が重なると、探したいものと別の指標を見つけてしまうおそれがあります。
- 短縮名は、ほかと重ならないようにする
- 戻り値が-1のときの処理を、先に決めておく
- 結果は、まずログに出して確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ウィンドウ番号は、0から数えるのか?
ChartWindowOnDroppedの説明には、0がメインのチャートウィンドウを意味する、と書かれています。サブウィンドウは、それ以降の番号で表されます。
- 0は、メインのチャートウィンドウ
- サブウィンドウは、それ以降の番号
短縮名が分からないときは、どうすればよいのか?
公式の説明では、短縮名は、サブウィンドウの左上に表示される文字列と結びついています。短縮名を明示していない場合は、ソースファイル名が使われます。
- サブウィンドウの左上の表示と結びついている
- 未設定なら、ソースファイル名が使われる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartWindowFindとChartWindowOnDropped、指標のサブウィンドウ番号を名前から探せる確実さとドロップした先のウィンドウ番号をそのまま受け取れる手軽さどっちを選ぶ?」
指標の名前から番号を探したいならChartWindowFind、ドロップした先の番号を知りたいならChartWindowOnDroppedです。記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










