MQL4(MT4) TextOutの使い方

TextOut関数は、MetaTrader 4 (MT4) のMQL4言語で、指定された位置にテキストを描画するために使用されます。この関数は、特にカスタムインジケーターやエキスパートアドバイザー(EA)内でチャートに直接テキストを表示したい場合に便利です。

TextOut関数の使用法

bool TextOut(
   long        chart_id,      // チャート識別子
   const string text,         // 描画するテキスト
   int         x,             // X座標（ピクセル単位）
   int         y,             // Y座標（ピクセル単位）
   uint        anchor,        // アンカー位置
   color       text_color,    // テキストの色
   string      font_name,     // フォント名
   int         font_size,     // フォントサイズ
   uint        flags=0,       // フラグ（太字、斜体など）
   int         angle=0        // テキストの角度
);

使用例

以下は、現在のチャートの左上隅に”Hello, World!”というテキストを描画する実装例です。

void OnStart()
{
    long chartID = ChartID(); // 現在のチャートIDを取得
    string text = "Hello, World!";
    int x = 10; // X座標
    int y = 20; // Y座標
    color textColor = clrRed; // テキストの色を赤に設定
    string fontName = "Arial"; // フォント名
    int fontSize = 12; // フォントサイズ

    // TextOut関数を使用してテキストを描画
    if(TextOut(chartID, text, x, y, ANCHOR_LEFT_UPPER, textColor, fontName, fontSize))
    {
        Print("テキストが描画されました: ", text);
    }
    else
    {
        Print("テキストの描画に失敗しました。");
    }
}

注意点

• 座標の指定: xとyの座標は、チャートウィンドウ内でのピクセル単位での位置を指定します。座標の起点はチャートウィンドウの左上隅です。
• アンカー位置: anchorパラメータは、テキストのアンカー（基準点）を指定します。ANCHOR_LEFT_UPPERなどの定数を使用して、テキストの配置を制御できます。
• フォントとスタイル: fontName、fontSize、flagsを使用して、テキストのフォント、サイズ、スタイル（太字、斜体など）を設定します。
• 色の指定: text_colorには、clrRedなどの定義済みの色定数またはRGB値を使用して、テキストの色を指定します。
• 描画の永続性: TextOutで描画されたテキストは、チャートの再描画（例えば、新しいティックの到着やチャートのスクロール）によって消去される可能性があります。永続的なテキスト表示が必要な場合は、OnChartEvent関数内で再描画イベントを処理するか、オブジェクト（OBJ_LABELやOBJ_TEXT）を使用してテキストを表示することを検討してください。

TextOut関数を使用することで、MQL4スクリプトから直接チャートにテキストを描画し、ユーザーに追加情報を提供することが可能になります。