この記事を開いてくださったこと、心から感謝しています。MQL5のEAで、チャートの左上に状態を表示したいと考えた人も多いはずです。
結論から言うと、とにかく手軽に表示したいならComment、表示先のチャートを指定したり戻り値で結果を受け取ったりしたいならChartSetStringのCHART_COMMENTが向いています。
ただし、一部の細かい動きは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの書き方の仕組み・制限・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
CommentとChartSetStringは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。
Commentは、値を渡すだけで左上に出せる
MQL5公式リファレンスによると、Commentは、ユーザーが決めたコメントを、チャートの左上の隅に出力する関数です。値はカンマで区切って、いくつでも並べられます。
戻り値はありません。チャートのIDを渡す引数もありません。呼び出した場所のチャートに、文字を出すための関数です。
- チャートの左上に出力する
- 値をカンマで並べて渡す
- 戻り値はない
ChartSetStringは、チャートのプロパティとして文字を設定する
ChartSetStringは、チャートの文字列のプロパティを設定する関数です。チャートのID、プロパティの種類、設定する文字列の3つを渡します。
プロパティにCHART_COMMENTを指定すると、チャートのコメント欄の文字を設定できます。公式ページには、Comment関数の代わりに、チャートへのコメント出力に使える、と書かれています。
- チャートID、種類、文字列を渡す
- CHART_COMMENTでコメント欄を設定する
- 戻り値は、命令を追加できたかどうか
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | Comment | ChartSetString |
|---|---|---|
| 表示先の指定 | 引数にチャートIDはない | チャートIDを渡す |
| 値の渡し方 | カンマ区切りで複数 | 文字列を1つ |
| 戻り値 | なし | bool(命令を追加できたか) |
| 長さの上限 | 全体で2045文字 | 2045文字まで |
※公式の説明をもとにした、筆者の整理です。
Commentには、どんな決まりがあるのか?
次に、Commentの公式ページに書かれている、引数や表示の決まりを見ていきます。
引数の数と、文字数の上限がある
公式ページには、引数の数は64個までと書かれています。入力したコメント全体の長さは、見えない文字も含めて、2045文字までです。超えた分は、出力のときに切り捨てられます。
複数の行に分けたいときは、改行の記号として、\nか\r\nを使います。配列は渡せないので、1つずつ要素を取り出して渡す必要があります。
- 引数は64個まで
- 全体で2045文字まで
- 改行は\nか\r\n
- 配列はそのままでは渡せない
値の型ごとに、出力の形が決まっている
公式ページには、型ごとの出力の形も書かれています。double型は、小数点以下16桁までで、通常の表記か指数表記の短いほうになります。float型は、小数点以下5桁です。
bool型はtrueかfalseで、日時は「YYYY.MM.DD HH:MI:SS」の形です。ほかの形にしたいときは、DoubleToStringやTimeToStringを使う、という説明があります。
| 型 | Commentでの出力 |
|---|---|
| double | 小数点以下16桁まで |
| float | 小数点以下5桁 |
| bool | true または false |
| 日時 | YYYY.MM.DD HH:MI:SS |
※公式の説明から読み取れる内容を、筆者が整理しました。
ストラテジーテスターの最適化では動かない
公式ページには、Comment関数は、ストラテジーテスターの最適化中は動かない、と書かれています。最適化の結果を画面で確かめる方法には、使えないということです。
- 最適化中は動かない
- 動作確認は通常の実行で行う
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
ChartSetStringには、どんな決まりがあるのか?
ここでは、ChartSetStringの公式ページに書かれている決まりを整理します。Commentとの違いが、はっきり見えてきます。
非同期で動き、戻り値は命令の追加結果になる
公式ページには、ChartSetStringは非同期の関数だと書かれています。戻り値のtrueは、命令をチャートの待ち行列に追加できたという意味です。プロパティが変わるのは、その命令が処理されてからです。
失敗したときは、falseが返ります。その理由は、GetLastErrorで調べます。結果を確かめたいときは、ChartGetStringを使う、という説明があります。
- 非同期で動く
- trueは命令を追加できた意味
- 失敗の理由はGetLastError
ChartRedrawで、すぐに反映させる
公式ページには、変更をすぐに反映したいときは、ChartRedrawを呼ぶ、と書かれています。複数のプロパティをまとめて変えるときは、呼び出しをまとめてから、ChartRedrawを1回呼ぶ方法が勧められています。
チャートのプロパティの一覧のページにも、設定の関数は変更の命令を送るだけなので、すぐに見た目が変わることは期待しないように、という説明があります。
| ページ | ChartRedrawの扱い |
|---|---|
| ChartSetString | すぐ反映したいときに呼ぶと説明 |
| プロパティ一覧 | すぐの更新は期待しないよう説明 |
| 公式のサンプル | ChartRedrawは呼んでいない |
※公式の説明から読み取れる内容を、筆者が整理しました。
文字数の上限は、Commentと同じ2045文字
設定する文字列の長さは、2045文字までです。超えた分は切り捨てられる、と書かれています。上限の数字は、Commentのページと同じです。
- 2045文字まで
- 超えた分は切り捨て
- Commentと数字は同じ
細かい動きは、確認できなかった
複数の引数をCommentで出力するとき、値の間にどんな区切りが入るかは、確認したページに記載なしでした。新しく呼ぶと前の文字が置き換わるのかも、記載なしです。
CommentとCHART_COMMENTが、完全に同じ動きをするのかも、確認できませんでした。空の文字列で消せるかどうかも、記載なしです。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。公式のサンプルも、買値と売値とスプレッドを3行で表示する、同じような形でした。
例の前提を、そろえる
EAが、買値と売値とスプレッドを、チャートの左上に3行で表示する場合を考えます。ティックが来るたびに、文字を更新するとします。
- 3行で状態を表示する
- ティックごとに更新する
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
Commentなら、1行で書ける
公式のサンプルでは、StringFormatで3行の文字列を作り、Commentに渡しています。書くのは1行だけで、戻り値も気にしなくてよいので、とても素直です。
- StringFormatで文字列を作る
- Commentに渡すだけで済む
- 戻り値は気にしなくてよい
ChartSetStringなら、チャートを指定できる
ChartSetStringのサンプルも、同じように3行の文字列を作り、チャートIDに0を指定して、CHART_COMMENTに設定しています。IDに別のチャートの番号を入れれば、別のチャートの左上にも出せる書き方です。
ただし、Commentのページには、別のチャートへ出せるかどうかは記載なしでした。そのため、ここでの違いは、引数の形から読み取れる範囲の整理です。
| 場面(仮) | 向いている書き方 |
|---|---|
| 今のチャートに手軽に出す | Comment |
| 別のチャートにも出したい | ChartSetString |
| 成功したかを戻り値で見たい | ChartSetString |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
手軽さを優先するなら、Commentを選ぶ
ひとまず状態を表示できればよい場合は、Commentが向いています。値をカンマで並べるだけで済むので、試作の段階でも書きやすいです。
画面の左上ではなく、ラベルで好きな位置に出したいときは、OBJ_LABELとOBJ_TEXTの記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
確かさを優先するなら、ChartSetStringを選ぶ
表示先のチャートを指定したい場合や、命令を追加できたかを確かめたい場合は、ChartSetStringが向いています。ChartRedrawと組み合わせて、反映のタイミングも自分で決められます。
画面に出すだけでなく、通知で知らせる方法との違いは、AlertとSendNotificationの記事で整理しています。
- チャートを指定できる
- 戻り値で追加の成否が分かる
- 反映のタイミングを決められる
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、2つの書き方を試してみましょう。同じ文字列を出して、見た目の違いや、更新の速さを目で確かめると、違いがよく分かります。









もう1つのコツは、表示する文字列を、別の関数でまとめて作っておくことです。StringFormatで文字列を作れば、どちらの書き方に切り替えても、中身を使い回せます。
また、長い文字列を出すときは、2045文字の上限を超えないよう、先に長さを確かめておくと安心です。ログに残す方法との違いも、あわせて考えておきましょう。
公式のPrintのページには、メッセージをEAのログに記録する関数だと書かれています。画面の左上に出すCommentとは、出す場所が違います。
- 文字列はStringFormatでまとめて作る
- 2045文字を超えないよう確かめる
- ログはPrint、画面の左上はComment
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
Commentは、配列をそのまま出せるのか?
いいえ。公式ページには、配列はCommentに渡せないので、要素を1つずつ入力する必要がある、と書かれています。Printも、同じ説明です。
- 配列は渡せない
- 要素を1つずつ渡す
ChartSetStringで設定すると、すぐ表示されるのか?
すぐとは限りません。公式ページには、命令は待ち行列に追加され、処理されてから反映される、と書かれています。すぐに反映したいときは、ChartRedrawを呼びます。
- 命令は待ち行列に入る
- すぐ反映したいならChartRedraw
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のCommentとChartSetString、1行で手軽にチャートへ文字を出せる気軽さと表示先のチャートを指定して結果も受け取れる確かさどっちを選ぶ?」
手軽に左上へ表示したいならComment、チャートを指定したり戻り値で結果を受け取ったりしたいならChartSetStringが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










