「Mery.iniのオプション値を取得」を編集中 (節単位)

== メモ ==
* 2019-03-10 ～ (sukemaru)
:* 将来的に INI を最新の状態に強制更新したり INI の設定項目を取得できる専用メソッドが実装されるかもしれませんし、現状でも [[includeライブラリ]]（[[includeライブラリ#MeryInfo.js|MeryInfo.js]]）によりある程度 INI へのアクセスはできますが…。
:* 一応、includeライブラリ（IO.js）の使用のみでエディタの表示状態を変更するマクロの例として「[[折り返しトグル切り替え]]」などもあります。
:* <div id="QueryStatusByID">［表示］ メニュー内などの各項目の '''✔'''チェックの ON／OFF 状態は Mery.ini から正しく取得できないことがありますが、[https://www.haijin-boys.com/software/mery/mery-3-1-0#10|Mery Ver 3.1.0] 以降では '''[[マクロリファレンス:3:Editor_オブジェクト#QueryStatusByID_メソッド|QueryStatusByID メソッド]] <code>editor.QueryStatusByID(id);</code>''' を利用することで取得できるようになりました。</div>
: ※ '''INI アクセスのための専用メソッド''' については [https://www.haijin-boys.com/discussions 公式フォーラム] 内のトピック『[https://www.haijin-boys.com/discussions/4081 マクロコマンドから「表示」の「色の反転」を取得したい]』で検討・議論されていますので、ご参考までに（セキュリティ上の '''懸念''' により実装は見送りとなっています）。
* '''導入事例'''
:*｢[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]｣｢[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]｣ マクロでは ｢行の表示方法｣(論理座標／表示座標) の取得に GetIniOption() 関数を利用しています。
:*｢[[ファイルを読み直す・開きなおす|読みなおし]]｣ マクロでは、GetIniOption() 関数を大幅に魔改造して ｢自動保存｣｢バックアップ｣ 関連の設定内容とすべての ｢編集モード名｣ を取得しています。
:*｢[[コンパクトメニュー]]｣ マクロでは GetIniOption() 関数をさらに魔改造して、｢最近のファイルの表示数｣ ｢無題タブ用のラベル｣ などの値や、｢編集モード名｣ ｢マクロ名｣ ｢プラグイン名｣ ｢外部ツール名｣ の一覧などを取得しています。
* 参照したい値が「数値」や「Ascii文字だけの文字列」であれば、記述が煩雑になる ADODB.Stream や拙作の関数を使わずに、FileSystemObject の <code>OpenTextFile()</code> と <code>ReadAll()</code> メソッドでも問題ありません（値が２バイト文字の場合、文字化けするので FileSystemObject は不適）。
: なお、Mery.ini の改行コードは CR+LF なので、検索で改行位置を利用する場合は <code>"\r\n"</code> を用います。
* 基本的に、｢編集モード｣ ｢マクロ｣ ｢プラグイン｣ ｢外部ツール｣ のショートカットキーは取得できません （キー名が32桁の16進数に符号化されていて「マクロ名」などで検索できないため）。