この記事を開いてくださったこと、心から感謝しています。チャートの上へ、自分で決めた文字をきれいに描きたいと考えている人も、きっと多いはずです。
結論から言うと、文字を画像の中へ描き込むならTextOut、描く前に文字の幅と高さを知りたいならTextGetSizeです。描く関数と測る関数という違いがあり、公式サンプルでは、2つが組み合わせて使われています。
また、動き方の細かい説明など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
TextOutとTextGetSizeは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つは文字を描く関数で、もう1つは文字の大きさを測る関数です。
TextOutは、文字を画像のデータへ描き込む
TextOutは、グラフィカルリソースを作るための配列へ、文字を描き込む関数です。チャートへ直接描くのではなく、画像の元になる配列へ描く点が、大きな特長です。
引数は、文字列、座標のxとy、アンカー、描き込む配列、幅と高さ、色、色の形式です。戻り値はbool型で、成功ならtrue、失敗ならfalseと説明されています。
- 画像の元になる配列へ、文字を描き込む
- 引数は、文字列・座標・アンカー・配列・サイズ・色・色の形式
- 戻り値のtrueは、成功を意味する
TextGetSizeは、文字の幅と高さを測る
TextGetSizeは、1行の文字列を、今のフォント設定で描いたときの幅と高さを返す関数です。何も描かずに、大きさだけを知りたいときに使います。
引数は、文字列と、幅と高さを受け取る2つの変数です。戻り値はbool型で、成功ならtrueです。失敗したときは、ERR_INTERNAL_ERROR(4001)の、OSのエラーが書かれています。
- 文字の幅と高さを、変数へ受け取る
- 引数は、文字列と、幅と高さの変数
- 失敗時のエラーは、4001の1つだけが記載されている
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | TextOut | TextGetSize |
|---|---|---|
| 役割 | 文字を配列へ描き込む | 文字の幅と高さを測る |
| 戻り値 | bool | bool |
| 引数の数 | 多い(9個) | 3個 |
| エラーコード | 記載なし | 4001(OSのエラー) |
| 同期か非同期か | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
TextOutは、どんな場面で使うのか?
TextOutは、チャート上のオブジェクトでは表せない、自由な文字の見せ方を作りたいときに使います。公式の説明から、引数と動き方を確認します。
アンカーで、文字のどこを座標に合わせるか決める
アンカーは、文字のどの位置を、指定した座標に合わせるかを決める引数です。水平方向と垂直方向の旗を1つずつ組み合わせ、全部で9つの位置から選べます。
水平方向は、TA_LEFT、TA_CENTER、TA_RIGHTです。垂直方向は、TA_TOP、TA_VCENTER、TA_BOTTOMです。公式ページには、9つの位置を示す図も載っています。
- 水平方向は、左・中央・右の3つ
- 垂直方向は、上・中央・下の3つ
- 旗の数値は、確認したページには記載なし
表示できるのは、1行の文字だけ
公式の説明では、TextOutで表示できるのは、1行の文字だけです。複数行の文章を出したいときは、行ごとに、座標を変えて呼ぶ形になります。
改行を含む文字列の動きは、確認したページには、記載なしでした。複数行を扱うときは、先に小さく試して、結果を確かめましょう。
- 表示できるのは、1行の文字だけ
- 複数行は、行ごとに呼び分ける
- 改行を含む文字列の動きは、記載なし
描いただけでは、チャートに見えない
TextOutが描き込むのは、あくまで配列の中です。画面に見せるには、ResourceCreateで配列から画像のリソースを作り、OBJ_BITMAP_LABELなどのオブジェクトから、そのリソースを指す必要があります。
公式サンプルも、この流れで作られています。文字を描いたあとに、ResourceCreateを呼び、ChartRedrawで画面を更新する形です。
- 描く先は、画像の元になる配列
- 見せるには、ResourceCreateでリソースにする
- オブジェクトが、リソース名を指して表示する
文字を画像にするので、チャートの文字オブジェクトとは使い分ける
チャートへ文字を出す方法は、ほかにもあります。固定して出すOBJ_LABELは、OBJ_LABELとOBJ_TEXTの記事で整理しています。1行で手軽に出す方法は、CommentとChartSetStringの記事が参考になります。
簡単に出したいだけなら、これらの方法のほうが短く書けます。TextOutは、フォントや向き、色の形式まで、自分で決めたいときの選択肢です。
- 手軽さを重視するなら、チャートの文字オブジェクト
- 見た目を細かく決めたいなら、TextOutで画像にする
- どちらが正しいかではなく、目的で選ぶ
TextGetSizeは、どんな場面で使うのか?
TextGetSizeは、描く前に、文字がどれくらいの場所を取るかを知りたいときに使います。文字を並べたり、枠に収めたりする場面で役立ちます。
測る大きさは、今のフォント設定で決まる
TextGetSizeは、TextSetFontで設定した、今のフォントで描いたときの大きさを返します。フォントを変えると、同じ文字でも、返る幅と高さが変わります。
そのため、測る前に、描くときと同じフォントを設定しておくことが大切です。フォントを設定しないときは、既定のフォントで測られます。
- 今のフォント設定での大きさが返る
- 描くときと同じフォントで測る
- フォント未設定なら、既定のフォントが使われる
引数の型は、公式の中で揃っていない
公式ページの書式では、幅と高さの引数は、符号なしの整数への参照です。一方で、同じページのサンプルでは、符号付きの整数の変数を渡しています。
この違いについて、ページに説明は、記載なしでした。サンプルを写すときは、自分の環境でコンパイルして、警告が出ないかを確かめるのが安心です。
- 書式は、符号なしの整数への参照
- サンプルは、符号付きの整数を渡している
- 違いの説明は、記載なし
測った結果は、文字を並べるために使える
公式サンプルは、文章を単語に分けて、1語ずつ幅を測り、横へ並べていきます。ここで、スペース1つ分の幅も測っておき、単語の間へ足します。
測った結果を使うと、文字が重ならずに並びます。測らずに座標を決め打ちすると、フォントを変えたときに、ずれやすくなります。
- 1語ずつ幅を測って、横へ並べる
- スペースの幅も、測って足す
- フォントを変えても、ずれにくくなる
公式のサンプルは、どう書かれているのか?
2つの関数には、それぞれ公式サンプルがあります。TextGetSizeのサンプルは、2つの関数が並んで使われる、分かりやすい例です。
TextGetSizeのサンプルは、測って、描いて、片づける
TextGetSizeのサンプルは、3つの文章を、スペースで単語に分けるところから始まります。そのあと、チャートの大きさに合わせたリソースと、OBJ_BITMAP_LABELを作ります。
スペースの幅と高さを測り、高さへ2を足します。そして、各単語を測りながらTextOutで描き、幅とスペースの分だけ、横へ進めていきます。最後は5秒待って、リソースとオブジェクトを消します。
- 単語に分けて、1語ずつ測る
- 測った幅の分だけ、横へ進めて描く
- 最後に、ResourceFreeとObjectDeleteで片づける
TextOutのサンプルは、時計を描く
TextOutのサンプルは、時計を描くスクリプトです。OBJ_BITMAP_LABELを作り、ビットマップのファイルとして、リソース名を指定します。
繰り返しの中で、配列を塗りつぶし、TextSetFontでフォントを設定します。1から12の数字と針を、TextOutで描き、ResourceCreateでリソースにして、ChartRedrawで画面を更新します。
| サンプル | 主な流れ |
|---|---|
| TextGetSize | 測って、描いて、横へ並べ、片づける |
| TextOut | 配列を消して、描いて、リソースにして、更新する |
※公式サンプルの内容を、筆者が整理しました。
サンプルを写すときの注意点
TextGetSizeのサンプルには、コメントと、コードの食い違いがあります。コメントでは、オブジェクトの基準点を中央にすると書かれていますが、コードでは、その設定が見当たりません。
これは、サンプルの書き方から読み取れる点です。公式の説明に、明記があるわけではありません。写すときは、基準点の設定を、自分で確かめましょう。
- コメントと、コードに食い違いがある
- 基準点の設定は、自分で確かめる
- 動かす前に、小さな範囲で試す
TextSetFontとResourceCreateは、何を知っておけばよいのか?
2つの関数だけでは、文字は画面に出ません。フォントを決めるTextSetFontと、リソースにするResourceCreateも、あわせて押さえておきます。
TextSetFontは、フォントを決める
TextSetFontは、TextOutとTextGetSizeが使うフォントを設定する関数です。既定は、Arialで、大きさはマイナス120、つまり12ポイントです。
大きさが正の値なら、ピクセル単位で、OSの拡大設定には従いません。負の値なら、10分の1ポイント単位で、OSの設定に従います。たとえばマイナス350は、35ポイントです。
- 既定のフォントは、Arialの12ポイント
- 正の値は、ピクセル単位
- 負の値は、10分の1ポイント単位
フォントの名前は、3通りの書き方ができる
名前には、システムのフォント名のほか、リソース名や、フォントファイルのパスも指定できます。コロン2つで始めると、EX5のリソースから読み込みます。
拡張子のある名前は、ファイルから読み込みます。スラッシュで始まるパスは、MQLフォルダからの相対パスで、それ以外は、呼び出したEX5の場所からの相対パスです。
- システムのフォント名を、指定できる
- コロン2つで、リソースから読み込む
- パスは、MQLフォルダかEX5の場所が基準
ResourceCreateは、配列から画像のリソースを作る
ResourceCreateには、2つの書き方があります。1つは、ファイルから読み込む形で、もう1つは、配列から動的に画像を作る形です。TextOutと組み合わせるのは、後者です。
リソースの大きさは、16MBを超えてはいけません。同じ名前で呼び直すと、新しく作らず、既存のリソースが更新される、と説明されています。
- 配列から、動的に画像を作れる
- 大きさの上限は、16MB
- 同じ名前で呼ぶと、更新される
記載のないことは、小さく試して確かめる
4つのページには、動き方が同期か非同期かの説明が、ありませんでした。TextOutのエラーコードや、文字数の上限も、記載なしです。
- 同期か非同期かは、記載なし
- TextOutのエラーコードは、記載なし
- 文字数の上限は、記載なし
どう使い分ければよいのか?
2つは競合する関数ではなく、役割が違います。描きたいのか、測りたいのかで、使い分けます。
描きたいなら、TextOutを選ぶ
文字を、フォントや向き、色まで決めて、画像の中へ置きたいときは、TextOutが向いています。時計の文字盤のような、自由な見せ方も作れます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
測りたいなら、TextGetSizeを選ぶ
文字を並べたり、枠へ収めたりしたいときは、TextGetSizeが向いています。描く前に大きさが分かるので、座標を計算できます。
- 文字を、横へ並べたい
- 枠の大きさを、文字に合わせたい
- フォントを変えても、ずれないようにしたい
組み合わせるなら、測ってから描く
公式のサンプルは、測ってから描く形でした。この順番は、文字が重なったり、はみ出したりするのを防ぐための、1つの形です。
- フォントを設定する
- TextGetSizeで測る
- 測った結果をもとに、TextOutで描く
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使って、文字を出すまでの順番を、公式サンプルの流れから整理します。小さな部品から、順に確認していくのが安心です。
まずは、配列とオブジェクトを用意する
最初に、描き込むための配列を用意し、リソース名を決めます。そして、OBJ_BITMAP_LABELを作り、ビットマップのファイルとして、リソース名を指定します。
- 描き込む配列を、用意する
- リソース名を、決める
- OBJ_BITMAP_LABELを、作る
次に、測って、描いて、更新する
フォントを設定したら、TextGetSizeで大きさを測り、その結果をもとに、TextOutで描きます。描いたあとに、ResourceCreateでリソースにして、ChartRedrawで更新します。
- フォントを設定してから、測る
- 測った大きさで、座標を決めて描く
- リソースにして、画面を更新する
最後に、リソースとオブジェクトを片づける
使い終わったら、リソースを解放し、オブジェクトを削除します。公式のサンプルでも、最後に、この2つを行っています。









もう1つのコツは、フォントの設定を、1か所にまとめておくことです。測るときと描くときで、フォントが違うと、ずれの原因になります。
- フォントの設定を、1か所にまとめる
- 結果は、まずログに出して確かめる
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
TextOutだけで、チャートに文字は出るのか?
いいえ、TextOutが描くのは、配列の中です。画面へ出すには、ResourceCreateでリソースにして、オブジェクトから指す必要があります。
- TextOutは、配列へ描くだけ
- 表示には、リソースとオブジェクトが必要
TextGetSizeが失敗したとき、何を調べればよいのか?
公式の説明では、エラーコードは、4001のOSのエラーだけが記載されています。それ以外の原因は、確認したページには、記載なしでした。
- 記載されているのは、4001の1つだけ
- それ以外の原因は、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のTextOutとTextGetSize、文字を絵として描き込める自由さと描く前に大きさを測れる確かさどっちを選ぶ?」
描くならTextOut、測るならTextGetSizeです。描いた配列は、リソースにして初めて見えると覚え、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










