MQL5チャートオブジェクト・パネルUI完全ガイド｜OBJ_LABEL・BUTTON・OnChartEventの基本

MQL5では、チャート上にラベル、ボタン、背景パネル、ステータス表示、ライン、テキストなどを配置できます。これらは総称してチャートオブジェクトとして扱われ、EA、インジケーター、裁量補助パネル、通知ボタン、確認用ステータス表示などで使われます。

この記事では、MQL5でパネルUIを作る時に特に使うことが多い OBJ_LABEL、OBJ_BUTTON、OBJ_RECTANGLE_LABEL、ObjectCreate、ObjectSetInteger、ObjectSetString、ObjectDelete、ChartRedraw、OnChartEvent の基本を整理します。

目的は、単に画面に文字やボタンを出すことではありません。表示系と判定系を分け、ボタンの見た目と実際のruntime状態を分け、時間足変更・EA削除・再セット・長時間稼働でも確認しやすいパネルUIを設計することです。

なお、本記事はMQL5の技術学習記事です。売買判断、特定銘柄、ロット設定、運用成績に関する助言は扱いません。EAやインジケーターの表示・確認・開発依頼前整理に必要な技術項目に限定して解説します。

この記事で扱う範囲

この記事では、チャート上に表示するオブジェクトと、クリックイベントを受け取る基本構造を扱います。パネルEA、裁量補助パネル、確認用ステータス表示、ログ提出前の状態表示などに共通する内容です。

この記事で扱う主な対象

この記事で深く扱わないこと

本記事では、注文処理、決済処理、ロット計算、外部API通信、WebRequest、Google Sheets連携、複数銘柄処理は主題にしません。これらは別の技術講座で扱う領域です。

また、パネルに表示されている状態をそのまま売買判定の根拠にする設計も扱いません。表示は確認用、判定は内部runtime stateという分離を基本にします。

チャートオブジェクトとは

チャートオブジェクトとは、MT5のチャート上に配置できる図形、ラベル、ボタン、ライン、テキスト、背景パーツなどの総称です。MQL5では、これらをプログラムから作成・更新・削除できます。

パネルUIで重要なのは、チャートオブジェクトには大きく分けて「価格や時刻に結び付くもの」と「画面上のピクセル位置に結び付くもの」がある点です。

パネルUIでは、主に画面固定系のオブジェクトを使います。理由は、チャートをスクロールしても、価格が変化しても、画面上の同じ位置に表示し続けたいからです。

パネルUIで画面固定系を使う理由

ステータス表示やボタンは、価格位置に合わせて動く必要がありません。むしろ、チャートを拡大縮小した時や時間足を変更した時でも、同じ位置に残っている方が確認しやすくなります。

そのため、パネル背景は OBJ_RECTANGLE_LABEL、文字は OBJ_LABEL、操作ボタンは OBJ_BUTTON のように役割を分ける構成が扱いやすくなります。

主要Object種別の比較

パネルUIを設計する場合、最初に「どのObjectを何のために使うか」を決めます。ラベル、背景、ボタン、ラインを混同すると、表示崩れやクリック判定の混乱が起きやすくなります。

パネルを安定させる基本は、1つのObjectに複数の責務を持たせないことです。背景は背景、文字は文字、ボタンは操作、ラインは価格確認というように分けます。

OBJ_LABELの基本

OBJ_LABEL は、チャート上に固定位置のテキストを表示するために使います。パネルUIでは、タイトル、ステータス、現在モード、最終更新時刻、ブロック理由、HELP文などに向いています。

OBJ_LABELで決める主な項目

OBJ_LABELの最小例

以下は、左上にステータスラベルを作る最小例です。実務では、同じ名前のObjectが存在する場合は作成せず、文字だけ更新するupsert方式にすると扱いやすくなります。

void UpsertStatusLabel(const string name,const string text)
{
   if(ObjectFind(0,name) < 0)
   {
      ObjectCreate(0,name,OBJ_LABEL,0,0,0);
      ObjectSetInteger(0,name,OBJPROP_CORNER,CORNER_LEFT_UPPER);
      ObjectSetInteger(0,name,OBJPROP_XDISTANCE,10);
      ObjectSetInteger(0,name,OBJPROP_YDISTANCE,20);
      ObjectSetInteger(0,name,OBJPROP_FONTSIZE,10);
      ObjectSetString(0,name,OBJPROP_FONT,"Arial");
      ObjectSetInteger(0,name,OBJPROP_SELECTABLE,false);
      ObjectSetInteger(0,name,OBJPROP_HIDDEN,true);
   }

   ObjectSetString(0,name,OBJPROP_TEXT,text);
}

この例では、表示と判定を分けるために、ラベルの文字列を内部判定の根拠にはしていません。判定結果を表示へ渡しているだけです。

OBJ_LABELで起きやすい問題

OBJ_RECTANGLE_LABELの基本

OBJ_RECTANGLE_LABEL は、画面固定の矩形を作るObjectです。パネル背景、カード背景、セクション枠、ステータスエリアの背景として使いやすいObjectです。

パネルUIでは、文字やボタンをそのままチャート上に置くより、背景矩形を作ってから、その上にラベルやボタンを配置した方が視認性を保ちやすくなります。

背景Objectとして使う時の考え方

背景Objectは、クリック対象ではなく、表示の土台として扱います。ボタンやラベルより背面に置き、選択不可、非表示扱い、必要に応じて背面化を行います。

OBJ_RECTANGLE_LABELを使う時の注意

背景Objectを頻繁に削除・再作成すると、ちらつきや前後関係の乱れが起きやすくなります。基本は一度作成し、必要な時だけサイズや色を更新する方式にします。

また、背景Objectがクリック対象の上に乗ると、ボタンが押せない、クリックイベントが届かない、見た目はあるのに反応しないといった問題が起きます。背景、文字、ボタンの順序は設計時点で固定してください。

OBJ_BUTTONの基本

OBJ_BUTTON は、チャート上にクリック可能なボタンを作るObjectです。パネルEAでは、ON/OFF、APPLY、CANCEL、RESET、HELP、SNAP、表示切替などに使われます。

重要なのは、ボタンの押下状態と、EA内部の実行状態を混同しないことです。ボタンはあくまで操作の入口であり、実際に何を有効にするかはruntime state側で管理します。

OBJ_BUTTONで決める主な項目

ボタン名の命名ルール

ボタン名は、クリックイベントで識別するための重要なキーです。画面に表示する文字と、内部Object名は分けて考えます。

Object名には、EA名や機能prefixを付けると、他のEAや手動Objectとの衝突を避けやすくなります。短く、用途が分かり、重複しない名前にします。

ObjectCreateとObjectSetの考え方

ObjectCreate はObjectを作成する関数です。作成後に、ObjectSetInteger、ObjectSetString、ObjectSetDouble などでプロパティを設定します。

実務では、Objectを毎回作り直すのではなく、「なければ作る、あれば必要なプロパティだけ更新する」方式が扱いやすくなります。この考え方をupsertと呼ぶことがあります。

Object操作関数の役割

毎tick作成ではなく差分更新にする

表示を更新するたびにObjectを削除して作り直すと、ちらつき、描画負荷、イベント混乱、前後関係の乱れが起きやすくなります。

実務では、初回だけObjectを作成し、以後は文字・色・位置など必要なプロパティだけを更新します。特にステータス表示は、前回値と同じなら更新しない設計が有効です。

OnChartEventでクリックを受ける

OnChartEvent は、チャート上のクリック、Objectクリック、チャート変更、キー操作などのイベントを受け取るためのイベントハンドラです。

ボタンUIでは、主に CHARTEVENT_OBJECT_CLICK を確認し、sparam に入るObject名を使って、どのボタンが押されたかを判断します。

OnChartEventの基本構造

void OnChartEvent(const int id,
                  const long &lparam,
                  const double &dparam,
                  const string &sparam)
{
   if(id == CHARTEVENT_OBJECT_CLICK)
   {
      if(sparam == "EAF_UI_BTN_HELP")
      {
         ShowHelpPanel();
         return;
      }

      if(sparam == "EAF_UI_BTN_SNAP")
      {
         PrintPanelSnapshot();
         return;
      }
   }

   if(id == CHARTEVENT_CHART_CHANGE)
   {
      RequestPanelRelayout();
      return;
   }
}

この例では、クリックされたObject名で処理を分けています。重要なのは、クリックイベントの中で重い処理を詰め込みすぎないことです。表示更新や再配置は、必要に応じて後続のOnTimerや軽量な再描画要求へ分けます。

クリックイベントで避けたい実装

パネルUIの基本設計

パネルUIは、見た目を整えるだけではなく、利用者が現在状態を確認しやすくするための設計です。どの項目を表示するか、どの操作をボタン化するか、どこまでをHELPやSNAPに分けるかを先に決めます。

基本構造はヘッダー・状態・操作・詳細に分ける

row templateを決めてから配置する

パネルが崩れやすい原因のひとつは、Objectごとに個別のX/Y座標を手で調整し続けることです。最初にrow height、left margin、label width、value width、button widthを決め、各部品を同じ計算式で配置します。

この方式にすると、後から項目を増やす時も、既存の行間や列幅を壊しにくくなります。

パネル部品の責務分離

表示系と判定系を分ける理由

チャート上の表示Objectは、あくまで人が確認するためのものです。EAやインジケーターの判定は、内部変数、構造体、取得済みデータ、runtime stateを基準にする必要があります。

表示Objectの文字や色を読み取って判定すると、文字変更、表示OFF、再描画失敗、時間足変更、再セット時の残存Objectなどで挙動が変わる可能性があります。

表示系と判定系の分離例

この分離ができていると、パネル表示に一時的な不具合が出ても、内部判定やログ確認で状態を追いやすくなります。

button stateとruntime stateの違い

OBJ_BUTTON には OBJPROP_STATE があります。これはボタンの押下状態を表すプロパティですが、EA内部の機能ON/OFFと必ず一致するとは限りません。

例えば、ボタンを押した直後に設定値の検証でNGになった場合、見た目は押された状態でも、実際の機能は有効化しない方がよい場合があります。そのため、button stateとruntime stateは分けて扱います。

APPLY、CANCEL、RESETのあるUIでは、この分離が特に重要です。編集中の値で即座に挙動が変わると、確認しにくくなります。画面で変更し、APPLYで確定し、ログやSNAPで反映状態を確認できる構造が扱いやすくなります。

Object lifecycleとOnDeinitの注意

Object lifecycleとは、Objectをいつ作り、いつ更新し、いつ削除し、再セット時にどう扱うかという設計です。パネルUIでは、見た目の整理だけでなく、終了時や再起動時の安定性も重要になります。

OnDeinitで全部削除すればよいとは限らない

EAやインジケーターの削除時に、すべてのObjectを広範囲に走査して削除しようとすると、環境やObject数によって終了処理が重くなる場合があります。特に他EA、手動ライン、残しておきたい確認ラインを巻き込まないようにする必要があります。

基本は、OnDeinitでは軽量処理に限定し、再セット時にstartup auditで残存Objectを検出・分類する方針が扱いやすくなります。

残してよいObjectと残すべきでないObjectを分ける

パネルのボタンや一時ステータスは、EA削除時に消した方が自然です。一方で、検証用ラインや履歴確認用ラインは、残す設計にする場合もあります。重要なのは、残すか消すかをObject種別ごとに仕様化することです。

残存オブジェクト・表示崩れ・フリーズ対策

パネルUIの不具合は、単純な座標ミスだけではありません。時間足変更、チャートリサイズ、EA再セット、他インジケーターとの重なり、Object数の増加、ログ過多、毎tick再描画などが組み合わさって起きる場合があります。

表示不具合の切り分け表

Object名prefixの重要性

複数のEAやインジケーターを同じチャートで使う場合、Object名が衝突する可能性があります。Object名には、EA名、機能名、用途、必要に応じてMagicやチャートID相当の識別子を含めます。

string ObjName(const string role)
{
   return "EAF_LEARN019_" + role;
}

このようにprefixを統一すると、作成、更新、監査、削除の対象を絞りやすくなります。手動Objectや他EAのObjectを巻き込まないためにも、prefix設計は最初に決めておきます。

差分更新とOnTimerメンテナンス

チャートObject更新は、毎tickで重くなりやすい処理です。価格が動くたびにパネル全体を再作成するのではなく、必要な時だけ差分更新します。

OnTickとOnTimerの役割分担

OnTimerメンテナンスの最小例

int OnInit()
{
   EventSetTimer(1);
   BuildPanel();
   return INIT_SUCCEEDED;
}

void OnTimer()
{
   if(g_panel_relayout_required)
   {
      RelayoutPanel();
      g_panel_relayout_required = false;
   }

   UpdatePanelIfChanged();
}

void OnDeinit(const int reason)
{
   EventKillTimer();
   Comment("");
}

この例では、OnDeinitで広範囲Object削除を行っていません。実際に削除するかどうかは、Object分類、prefix、EA仕様、残存時の扱いを決めてから実装します。

ログ・HELP・SNAPをパネルUIに組み込む

パネルUIは、画面で見るためだけではなく、問い合わせ前の情報整理にも使えます。HELP、SNAP、INIT/SELFCHECKを用意しておくと、利用者が現在状態を記録しやすくなります。

SNAPログでは、機密情報、口座番号、外部URL、認証トークンなどを出さないようにします。出すのは、状態確認に必要な分類名、ON/OFF、reason、時刻、バージョン、Object数などに限定します。

パネルEA開発依頼前に整理すること

パネルEAやチャートUI付きインジケーターの開発を依頼する場合は、見た目の希望だけでなく、どの情報を表示し、どの操作をボタン化し、どの状態をログへ残すかを整理しておくと仕様化しやすくなります。

依頼前に整理する項目

問い合わせ時にあると確認しやすい情報

パネル表示やObject関連の不具合を相談する場合は、EA名、バージョン、対象チャート、時間足、発生時刻、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。

特に、時間足変更時だけ崩れるのか、EA削除時に残るのか、再セット時に混ざるのか、長時間放置で重くなるのかを分けると、原因を切り分けやすくなります。

次に読む技術講座

この講座とあわせて確認すると、MT5・MQL5開発、検証、不具合調査の流れを整理しやすくなります。

次に確認するページ

技術講座を確認した後、導入・商品確認・開発相談・不具合報告へ進む場合は、以下のページも確認してください。

よくある質問

OBJ_LABELとOBJ_RECTANGLE_LABELは何が違いますか？

OBJ_LABEL は主に文字表示に使います。OBJ_RECTANGLE_LABEL は矩形の背景や枠に使います。パネルUIでは、背景を OBJ_RECTANGLE_LABEL、文字を OBJ_LABEL に分けると管理しやすくなります。

ボタンを押した時の処理はどこで受けますか？

OnChartEvent で受けます。CHARTEVENT_OBJECT_CLICK を確認し、sparam に入るObject名で押されたボタンを判定します。表示文字ではなくObject名で分岐するのが基本です。

OnDeinitで全部削除すればよいですか？

常に全部削除すればよいとは限りません。パネル操作用Objectは削除対象になりやすい一方、検証用ラインや履歴確認用Objectは残す仕様にする場合があります。広範囲削除ではなく、prefix、用途、Object分類で対象を絞ることが重要です。

表示オブジェクトを判定ロジックに使ってよいですか？

基本的には避けます。表示Objectは人が確認するための出力です。判定は内部変数、構造体、取得データ、runtime stateを基準にし、表示はその結果を反映するだけにします。

パネルが重くなる原因は何ですか？

毎tickで大量のObjectを削除・再作成している、ChartRedrawを頻繁に呼んでいる、Object数が増え続けている、ログが多すぎる、時間足変更時に全再構築している、といった原因が考えられます。差分更新とOnTimerメンテナンスで負荷を分散します。

時間足変更で表示が崩れる時は何を確認しますか？

CHARTEVENT_CHART_CHANGE の受け取り、座標基準、row template、Objectの再配置処理、前後関係、font size、パネル幅を確認します。個別のY座標を都度微調整するより、配置ルール全体を見直す方が安定しやすくなります。

EA削除時にラインが残っても問題ですか？

仕様として残すObjectであれば問題とは限りません。ただし、再セット時に古いラインを実ロジックへ無条件で使わない設計が必要です。残すObject、消すObject、監査だけするObjectを分類してください。

パネルEA開発依頼前に何を用意しますか？

希望する表示項目、ボタン操作、入力欄、表示位置、更新頻度、発生している不具合、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。既存EAや既存インジがある場合は、対象ファイル名とバージョンも記録してください。

まとめ

MQL5のチャートオブジェクトは、パネルUI、状態表示、ボタン操作、確認用ラインを作るうえで重要な機能です。ただし、Objectを表示できることと、安定して運用・検証・問い合わせ対応できることは別です。

パネルUIでは、OBJ_LABEL、OBJ_RECTANGLE_LABEL、OBJ_BUTTON の役割を分け、OnChartEvent でクリックを受け、Object名prefix、差分更新、OnTimerメンテナンス、Object lifecycle、OnDeinit方針を整理します。

特に重要なのは、表示系と判定系を分けること、button stateとruntime stateを分けること、残存Objectを実ロジックへ無条件で使わないことです。これらを整理しておくと、パネル表示の不具合や再セット時の確認がしやすくなります。

学習内容を確認しても整理が難しい場合は、EA名、バージョン、setファイル、Expertsログ、Journalログ、発生時刻、スクリーンショットを整理したうえで相談してください。