MQL4(MT4) TextSetFontの使い方

TextSetFontは、MetaTrader 4 (MT4) のMQL4言語において、チャート上のテキストラベルオブジェクトのフォントを設定するために使用される関数です。この関数を用いることで、フォント名、サイズ、スタイルフラグ、テキストの傾き角度を指定することができます。

TextSetFont関数の使用法

bool TextSetFont(
   const string name,          // フォント名またはディスク上のフォントファイルへのパス
   int size,                   // フォントサイズ
   uint flags=0,               // フラグの組み合わせ
   int orientation=0           // テキストの傾斜角度
);

使用例

以下は、チャート上のテキストラベルのフォントを設定する実装例です。

void OnStart()
{
    // チャートにテキストラベルを作成
    string objectName = "MyLabel";
    if(ObjectCreate(0, objectName, OBJ_LABEL, 0, 0, 0))
    {
        // 作成したテキストラベルのプロパティを設定
        ObjectSetString(0, objectName, OBJPROP_TEXT, "Sample Text");
        ObjectSetInteger(0, objectName, OBJPROP_CORNER, CORNER_LEFT_UPPER);
        ObjectSetInteger(0, objectName, OBJPROP_XDISTANCE, 10);
        ObjectSetInteger(0, objectName, OBJPROP_YDISTANCE, 20);

        // テキストラベルのフォントを設定
        if(!TextSetFont(objectName, "Arial", 12, 0, 0))
        {
            Print("フォント設定に失敗しました。");
        }
        else
        {
            Print("フォントが設定されました。");
        }
    }
    else
    {
        Print("テキストラベルの作成に失敗しました。エラー: ", GetLastError());
    }
}

注意点

• nameパラメータには、システムにインストールされているフォント名を指定するか、カスタムフォントファイルへのパスを指定します。
• flagsパラメータを使用して、フォントスタイル（太字、斜体など）の組み合わせをビットフラグで指定できます。例えば、FW_BOLD | ITALICのように指定します。
• orientationパラメータで、テキストの傾きを設定できます。この値は度数法で指定され、正の値は時計回りの傾斜を意味します。
• 関数がfalseを返した場合、フォント設定に失敗しています。これは指定されたフォントがシステムに存在しない、またはパスが正しくない場合に起こり得ます。

TextSetFont関数により、MQL4スクリプトでテキストオブジェクトの視覚的表現をより細かく制御することが可能になります。