ツール全体の概要

MQL Lang Tool は、MT4/5の .mq4 / .mq5 ファイルを対象に、EA・インジケーターなどを多言語対応させるための開発者向けツールです。

本ツールの主な機能は次の2つです：

1. 🔄 GetText関数の適用

【目的】

.mq4 / .mq5 ソースファイル内の表示テキストに GetText("〜") を適用し、多言語対応用の形に変換します。

【手順】

1. ファイルを読み込む
   - 📂 mq4/mq5ファイルをドロップまたはクリックして選択 に、翻訳対象の .mq4 または .mq5 ファイルをドロップ or 選択
   
2. 辞書ファイルを読み込む行の追加
   - ✚「mqhファイルの読込を追加」ボタンで、辞書ファイルを読み込むための行・#include <Lang_ファイル名.mqh> を自動挿入
   - 既に同様の行がある場合は追加されません
3. 文字列の変換
   - 表示されたコード中の "文字列" をホバー
   → 🌐 多言語対応させる をクリックすると GetText("文字列") に変換
   - 既に GetText() が使われている場合は、↩️ 元に戻す で元の "文字列" 表記に戻せます
4. 操作の補助
   - 🔄「変換実行」：選択中の箇所を変換
   - ⬅️➡️「前へ」「次へ」：対象箇所を移動
5. 変換後の保存
   - 📥「変換後のファイルをダウンロード」で、変換された .mq4/.mq5 を取得

【補足】

• input, extern, #property の行などは自動スキップされます。
• 関数内部の表示テキストだけが対象になります。
• input, externで定義する入力パラメーターは、MT4/MT5自体の仕様の問題で多言語対応させることができません。パラメーター名は英語で記載しておくことをおすすめいたします。

2. 🔠 mqhファイルの生成

【目的】

GetText("KEY") に対応する翻訳テーブルを .mqh ファイル（辞書ファイル）として生成します。

【手順】

1. 翻訳対象を読み込む
   - 左側のドロップエリアで .mq4 / .mq5 ファイルを読み込むと、GetText("KEY") を自動抽出
   - 必要に応じて、右側のドロップエリアで既存の Lang_***.mqh を読み込むことで、作成済の辞書ファイルの情報を引き継げます
2. 翻訳を入力
   - 表形式で表示される翻訳欄に、翻訳文を入力します
   - 複数行貼り付けに対応しています
   - 上下左右キーでセルの移動、エンターキーで編集モードの切り替えが可能です
3. 補助機能の活用
   - 指定言語のコピー（例：日本語選択時のテキストとしてKeyをそのまま使う場合は Key → Japanese）
   - デフォルト言語の選択（「ユーザーのMT4/5の言語が日本語・英語以外の場合に使用される言語」を選択することができます）
4. 保存
   - 📥「mqhファイルをダウンロード」で翻訳データを .mqh ファイルとして保存

【補足】

- デフォルトの言語の列に空欄がある場合はダウンロードできないようにする、操作ミス防止機能が搭載されています

3. 動作確認方法

【手順】

1. ファイルの設置
   - GetText()適用後の .mq4 / .mq5 ファイルを、EAの場合は Experts フォルダ、インジケーター場合は Indicators フォルダに設置します
   - 辞書ファイルを Include フォルダに設置します
2. コンパイル
   - mq4/mq5 ファイルをMetaEditorで開き、「コンパイル」 ボタンを押してコンパイルします
3. ツールをチャートに適用
   - MT4/MT5でツールをチャートにドラッグアンドドロップします
4. 言語設定を変更
   - 「表示」>「言語」から言語を変更し、MT4/5を再起動すると、辞書ファイルに登録された情報を元に表示内容が変更されます