この記事を開いてくださったこと、心から感謝しています。MQL5でチャートの見た目を整えたいとき、テンプレートを使うか迷った人も多いはずです。
結論から言うと、色や指標やオブジェクトをまとめて整えたいならChartApplyTemplate、項目を1つずつ確かめながら変えたいならChartSetIntegerが向いています。
ただし、一部の細かい動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、関数の仕組み・動き方・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartApplyTemplateとChartSetIntegerは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。
ChartApplyTemplateは、ファイルの設定をまとめて適用する
MQL5公式リファレンスによると、ChartApplyTemplateは、指定したファイルのテンプレートをチャートに適用する関数です。チャートのIDとファイル名の2つを渡します。
テンプレートには、チャートの色の設定や、指標、描画したオブジェクトを保存できる、と書かれています。つまり、見た目を一式まとめて切り替えられます。
- チャートのIDとファイル名を渡す
- 色・指標・オブジェクトをまとめて扱える
- IDが0なら現在のチャート
ChartSetIntegerは、プロパティを1つずつ設定する
ChartSetIntegerは、チャートのプロパティを、1つずつ指定して設定する関数です。たとえば、色や表示のオンオフを、項目ごとに変えられます。
詳しい種類や動き方は、ChartSetIntegerとChartSetDoubleの記事で整理しています。
- 項目を1つ指定して設定する
- 色や表示のオンオフを扱える
- 指標やオブジェクトの追加は扱わない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartApplyTemplate | ChartSetInteger |
|---|---|---|
| 設定の単位 | テンプレート一式 | プロパティ1つ |
| 渡すもの | チャートIDとファイル名 | IDとプロパティと値 |
| 戻り値 | bool(命令を追加できたか) | bool(命令を送れたか) |
| 動き方 | 待ち行列に入る | 非同期 |
※公式の説明をもとにした、筆者の整理です。
ChartApplyTemplateには、どんな決まりがあるのか?
次に、ChartApplyTemplateを使うときの決まりを見ていきます。ここを知らないと、思わぬ形でEAが止まることがあります。
適用に成功すると、EAは外される
公式ページには、EAが付いているチャートに新しいテンプレートを読み込めたとき、そのEAは外されて、動作を続けられない、と書かれています。
また、テンプレートの適用で起動したEAには、売買の許可を広げる力はない、とも書かれています。呼び出した側に許可がなければ、起動したEAも売買できません。
- 成功すると元のEAは外される
- 売買の許可は広がらない
- 呼び出し側に許可がないと売買できない
テンプレートのファイルは、決まった順で探される
先頭にバックスラッシュを付けると、データフォルダのMQL5の下から探されます。付けないと、呼び出したEX5ファイルのフォルダから探されます。
どちらでも見つからないときは、ターミナルのProfiles\Templatesの下が探されます。テンプレートはリソースではないので、EX5ファイルには含められません。
| 書き方 | 探される場所 |
|---|---|
| 先頭にバックスラッシュあり | データフォルダのMQL5の下 |
| 先頭にバックスラッシュなし | EX5ファイルのフォルダ |
| どちらでも見つからない | Profiles\Templatesの下 |
※公式の説明から読み取れる内容を、筆者が整理しました。
戻り値と細かい動きは、確認できなかった部分がある
戻り値のtrueは、命令をチャートの待ち行列に追加できた、という意味です。適用が成功したかどうかまでは分かりません。失敗したときはGetLastErrorで調べます。
無効なチャートIDを渡したときの動きは、確認したページに記載なしでした。テンプレートの形式が正しくないときの動きも、記載なしです。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
テンプレートの保存には、どんな決まりがあるのか?
テンプレートを使うには、先にファイルを作る必要があります。ここでは、保存に使うChartSaveTemplateの説明を整理します。
ChartSaveTemplateは、今の設定をファイルにする
ChartSaveTemplateは、チャートの今の設定を、指定した名前のテンプレートとして保存する関数です。拡張子の.tplは、自動で付くので、書く必要はありません。
保存先はデータフォルダのProfiles\Templatesで、同じ名前のファイルがあると、内容が上書きされる、と書かれています。
- 拡張子の.tplは自動で付く
- 保存先はProfiles\Templates
- 同じ名前だと上書きされる
公式のサンプルは、保存して別のチャートに適用している
ChartSaveTemplateのサンプルは、チャートにZigzagと標準偏差チャネルを置いて保存し、新しいチャートを開いて、そのテンプレートを適用する内容です。
保存の呼び出しの戻り値は、サンプルの中で確認されていませんでした。適用の呼び出しの戻り値も、同じく確認されていません。
- 指標とオブジェクトを置いて保存する
- 新しいチャートを開いて適用する
- 戻り値は確認されていない
ここから読み取れることと、読み取れないこと
保存と適用を組み合わせれば、ある設定を別のチャートに移せる、という流れは、サンプルから読み取れます。一方で、実行できる場所の制限は、ページに記載なしでした。
| 確認できること | 確認できないこと |
|---|---|
| 保存したファイルを別のチャートに適用できる | 指標やテスターで使えるか |
| 同名のファイルは上書きされる | フォルダに書き込めないときの動き |
※公式の説明から読み取れる内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。
例の前提を、そろえる
チャートの背景色と、ローソク足の色だけを変えたい場合と、指標も含めた見た目一式を切り替えたい場合を考えます。
- 色だけを変えたい場合
- 指標を含めて一式を切り替えたい場合
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
色だけなら、ChartSetIntegerが書きやすい
色の変更だけなら、ChartSetIntegerで必要な項目だけを設定する書き方が考えられます。ファイルを用意する必要がなく、変えた項目も、コードを見れば分かります。
- ファイルを用意しなくてよい
- 変えた項目がコードに残る
- EAが外される心配がない
一式なら、ChartApplyTemplateが手軽
指標やオブジェクトも含めて切り替えたいなら、テンプレートを1回適用するほうが、手軽です。ただし、適用に成功するとEAが外される点には、注意が必要です。
| 場面(仮) | 向いている書き方 |
|---|---|
| 背景色だけ変える | ChartSetInteger |
| 指標も含めて一式を切り替える | ChartApplyTemplate |
| EAを動かしたまま変える | ChartSetInteger |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
手軽さを優先するなら、ChartApplyTemplateを選ぶ
見た目を一式まとめて整えたいときは、ChartApplyTemplateが向いています。指標やオブジェクトも、いっしょに切り替えられるからです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
確かさを優先するなら、ChartSetIntegerを選ぶ
EAを動かしたまま、一部の項目だけを変えたいときは、ChartSetIntegerが向いています。変える項目を、自分で狙って決められます。
オブジェクトを動かす関数の使い分けは、ObjectMoveとObjectSetIntegerの記事でも整理しています。
- EAを動かしたまま変えたい
- 変える項目を自分で決めたい
- 変更の中身をコードに残したい
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、テンプレートの適用と個別の設定の両方を試してみましょう。見た目の変わり方と、EAの状態を確かめると、違いがよく分かります。









試すときは、適用の前後で、チャートの色・指標の数・EAの状態を書き出しておくと、何が変わったのかを、あとから見比べられます。
また、保存したテンプレートは、同じ名前で上書きされるため、大切な設定は、名前を変えて残しておくと安心です。この点は、保存の説明から読み取れる内容です。
もう1つのコツは、見た目を変える処理を、1つの関数にまとめておくことです。あとから、テンプレートと個別の設定を入れ替えたくなったときも、直す場所が1か所で済みます。
- 見た目を変える処理を1つにまとめる
- 戻り値とGetLastErrorを確認する
- テンプレートのファイル名と置き場所を決めておく
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
テンプレートを適用すると、EAはどうなるのか?
公式ページによると、EAが付いたチャートに新しいテンプレートを読み込めたとき、そのEAは外されて、動作を続けられません。
- 成功すると外される
- 売買の許可も広がらない
テンプレートのファイルは、どこに置けばよいのか?
先頭にバックスラッシュがあるかどうかで、探される場所が変わります。見つからない場合は、Profiles\Templatesの下が探されます。
- 先頭のバックスラッシュで探す場所が変わる
- 最後にProfiles\Templatesが探される
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartApplyTemplateとChartSetInteger、テンプレートで見た目をまとめて整えられる手軽さと項目ごとに狙って変えられる確かさどっちを選ぶ?」
見た目を一式で切り替えるならChartApplyTemplate、EAを動かしたまま項目を変えるならChartSetIntegerが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










