MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のTextOutとTextGetSize、文字を絵として描き込める自由さと描く前に大きさを測れる確かさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のTextOutとTextGetSize、文字を絵として描き込める自由さと描く前に大きさを測れる確かさどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のTextOutとTextGetSizeの比較

この記事を開いてくださったこと、心から感謝しています。チャートの上へ、自分で決めた文字をきれいに描きたいと考えている人も、きっと多いはずです。

結論から言うと、文字を画像の中へ描き込むならTextOut、描く前に文字の幅と高さを知りたいならTextGetSizeです。描く関数と測る関数という違いがあり、公式サンプルでは、2つが組み合わせて使われています。

また、動き方の細かい説明など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のTextOutとTextGetSizeの違いをまとめたインフォグラフィック
目次

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つを行っています。

描く関数と測る関数だと分かって、全体像が整理できました。調べてよかったです。
描いただけでは見えず、リソースが必要だと分かって、順番の大切さが身にしみました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
2つの役割の違いが見えたら、場面ごとの使い方が整理されて、コードを書くのが楽しみになりました。

もう1つのコツは、フォントの設定を、1か所にまとめておくことです。測るときと描くときで、フォントが違うと、ずれの原因になります。

  • フォントの設定を、1か所にまとめる
  • 結果は、まずログに出して確かめる
  • 記載なしの点は、小さく試す

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

TextOutだけで、チャートに文字は出るのか?

いいえ、TextOutが描くのは、配列の中です。画面へ出すには、ResourceCreateでリソースにして、オブジェクトから指す必要があります。

  • TextOutは、配列へ描くだけ
  • 表示には、リソースとオブジェクトが必要

TextGetSizeが失敗したとき、何を調べればよいのか?

公式の説明では、エラーコードは、4001のOSのエラーだけが記載されています。それ以外の原因は、確認したページには、記載なしでした。

  • 記載されているのは、4001の1つだけ
  • それ以外の原因は、記載なし

この記事の例は、実際の結果なのか?

いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。

  • 公式サンプルの内容をもとにした説明
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のTextOutとTextGetSize、文字を絵として描き込める自由さと描く前に大きさを測れる確かさどっちを選ぶ?」

描くならTextOut、測るならTextGetSizeです。描いた配列は、リソースにして初めて見えると覚え、記載のない点は自分の環境で確かめてから使いましょう。

  • 描くならTextOut
  • 測るならTextGetSize
  • 記載なしの点は自分で確かめる

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(TextOut)
  • MQL5 リファレンス(TextGetSize)
  • MQL5 リファレンス(TextSetFont)
  • MQL5 リファレンス(ResourceCreate)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のObjectCreateとObjectFind、チャートへ線やラベルを置ける自由さと同じ名前のオブジェクトがあるか確かめられる確実さどっちを選ぶ?
  • MQL5のMessageBoxとPlaySound、返事が返るまで止めて確かめられる確実さと処理を止めずに音で知らせられる身軽さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次