MQL4(MT4) ObjectSetStringの使い方

ObjectSetString関数は、MetaTrader 4 (MT4) プラットフォームのMQL4言語で、チャート上の特定のグラフィカルオブジェクトの文字列型プロパティを設定するために使用されます。文字列型プロパティには、オブジェクトの名前や説明などが含まれます。この関数には、修飾子なしでプロパティ値を設定するバージョンと、修飾子を指定してプロパティ値を設定するバージョンの2つがあります。

修飾子なしでプロパティ値を設定

bool ObjectSetString(
   long chart_id,         // チャート識別子
   string object_name,    // オブジェクト名
   int prop_id,           // プロパティ
   string prop_value      // 値
);

修飾子を指定してプロパティ値を設定

bool ObjectSetString(
   long chart_id,         // チャート識別子
   string object_name,    // オブジェクト名
   int prop_id,           // プロパティ
   int prop_modifier,     // 修飾子
   string prop_value      // 値
);

使用例1: オブジェクトのテキストを設定（修飾子なし）

チャート上のテキストオブジェクトの内容を更新する例です。

void OnStart()
{
    long chartID = ChartID(); // 現在のチャートIDを取得
    string objectName = "MyTextObject";
    int propID = OBJPROP_TEXT; // テキストプロパティ識別子
    string newText = "Hello, World!"; // 新しいテキスト内容

    if(ObjectSetString(chartID, objectName, propID, newText))
    {
        Print("オブジェクト '", objectName, "' のテキストが '", newText, "' に更新されました。");
    }
    else
    {
        Print("テキストプロパティの設定に失敗しました。");
    }
}

使用例2: フィボナッチレベルの説明を設定（修飾子あり）

フィボナッチリトレースメントオブジェクトの特定のレベルの説明を設定する例です。

void OnStart()
{
    long chartID = ChartID();
    string objectName = "MyFibo";
    int propID = OBJPROP_LEVELTEXT; // レベルのテキストプロパティ識別子
    int levelIndex = 1; // 更新したいレベルのインデックス（例: レベル1）
    string levelDescription = "New Level Description"; // 新しいレベルの説明

    if(ObjectSetString(chartID, objectName, propID, levelIndex, levelDescription))
    {
        Print("フィボナッチオブジェクト '", objectName, "' のレベル ", levelIndex, " の説明が '", levelDescription, "' に更新されました。");
    }
    else
    {
        Print("レベルテキストプロパティの設定に失敗しました。");
    }
}

注意点

• プロパティ識別子の正確性: prop_idには、設定したいプロパティの種類を指定します。例えば、OBJPROP_TEXTはテキストオブジェクトの内容、OBJPROP_LEVELTEXTはフィボナッチリトレースメントのレベル説明などです。
• 修飾子の使用: 修飾子を使用するバージョンは、フィボナッチリトレースメントのレベルなど、特定のプロパティに対してより細かい制御が必要な場合に便利です。
• 関数の戻り値: ObjectSetString関数は、操作が成功したかどうかをbool値で返します。プロパティの設定が失敗した場合、falseが返されます。この場合、GetLastError関数を使用してエラーの原因を特定することができます。

これらの関数を使用することで、プログラム的にチャートオブジェクトのプロパティ値を動的に調整し、分析や取引戦略に応じてチャートの表示をカスタマイズすることが可能になります。