「マクロ覚え書き(開発者向け)」の版間の差分
改行とマークアップの修正 |
句読点の修正 |
||
| 1行目: | 1行目: | ||
== 概要 == | == 概要 == | ||
マクロ開発者向けの覚え書きです。 | |||
リファレンスなどに載っていない、豆知識的なことを集めています。 | |||
== 覚え書き == | == 覚え書き == | ||
=== 開発言語について === | === 開発言語について === | ||
WSH(Windows Script Host) | WSH(Windows Script Host) が対応している言語であれば利用が可能です。 | ||
標準では JScript(≒javascript)と VBScript | 標準では JScript(≒javascript)と VBScript が入っています。 | ||
他の言語(Perl や | 他の言語(Perl や Python)もインストールすれば使えますが、一般配布する場合利用者もインストールが必要になります。 | ||
どの言語でも良いですが、JScript での開発者が多いため、JScript の方が情報が集まりやすくお勧めです。 | |||
=== マクロを保存する際の文字コード === | === マクロを保存する際の文字コード === | ||
基本的に単体で利用する場合はどの文字コードでも構いません。 | |||
ただし「他のマクロから読まれる」場合は文字コードの選択が重要になります。 | |||
今のマクロでは #title | 今のマクロでは #title のようなプリプロセス処理が必要で、それに対応したロードができる include ライブラリの IO.Include はデフォルトで UTF-8 対応なので、UTF-8 をお勧めします(個別の指定は可能)。 | ||
ただし読み込む側が FileSystemObject | ただし読み込む側が FileSystemObject を利用している場合、SJIS/Unicode しか対応できないのでその場合は SJIS をお勧めします(Mery 1 時代のマクロなどはコレです)。 | ||
=== window.Document と Editor.ActiveDocument の違い === | === window.Document と Editor.ActiveDocument の違い === | ||
window.Document | window.Document は、マクロ開始時にアクティブなドキュメントを指し続けます。マクロで別のドキュメントを Activate しても変わりません。 | ||
Editor.ActiveDocument | Editor.ActiveDocument は、その時点でアクティブなドキュメントを指します。マクロで別のドキュメントを Activate すると当然変わります。 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
Editor.Documents.Item(0).Activate(); | Editor.Documents.Item(0).Activate(); | ||
| 32行目: | 32行目: | ||
Alert(Editor.ActiveDocument.Name); | Alert(Editor.ActiveDocument.Name); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
また、window.Document は Documents.Item() と一致しませんが、Editor.ActiveDocument は一致します。 | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
for (var i=0; i<Editor.Documents.Count; i++) { | for (var i=0; i<Editor.Documents.Count; i++) { | ||
| 49行目: | 49行目: | ||
Redraw = false; | Redraw = false; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
にしたとき、最後 | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
Redraw = true; | Redraw = true; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
が必要かという点については、現状確認する限りでは不要です。 | |||
=== 矩形選択の扱い === | === 矩形選択の扱い === | ||
マクロで矩形選択は扱えません(プラグインですら無理)。 | |||
ただし、矩形選択中かの判定だけは以下の方法で可能です。 | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
var s = Document.Selection; | var s = Document.Selection; | ||
| 69行目: | 69行目: | ||
=== Document.GetLines の引数 === | === Document.GetLines の引数 === | ||
リファレンスには '''meGetLineView''' | リファレンスには '''meGetLineView''' しか書かれていませんが、論理行単位での行数取得には引数に 0 を渡します。 | ||
'''meGetLineLogical''' | '''meGetLineLogical''' という定数はありません。 | ||
=== プリプロセス(#title など) === | === プリプロセス(#title など) === | ||
対応しているプリプロセスコードは以下の通りです。 | |||
* <code>#icon = "****" [, アイコン番号]</code> | * <code>#icon = "****" [, アイコン番号]</code> | ||
* <code>#title = "****"</code> | * <code>#title = "****"</code> | ||
* <code>#tooltip = "****"</code> | * <code>#tooltip = "****"</code> | ||
* <code>#include "****.js"</code> | * <code>#include "****.js"</code> | ||
* <code>#language = "****"</code>[https://www.haijin-boys.com/software/mery/mery-2-6-6#5] | * <code>#language = "****"</code>[https://www.haijin-boys.com/software/mery/mery-2-6-6#5] (スクリプトの言語を指定。 ※[https://www.haijin-boys.com/software/mery/mery-2-6-7#9 省略時は "JScript(Chakra)"]) | ||
* <code>#begingroup = true</code>[https://www.haijin-boys.com/software/mery/mery-2-8-0#4] (または 1 - 3 | * <code>#begingroup = true</code>[https://www.haijin-boys.com/software/mery/mery-2-8-0#4] (または 1 - 3 の数値。 ※Mery 2.8.0 以降のみ) | ||
これらは必ず '''ファイル先頭''' に書かなければなりません(コメントや VBS の Option Explicit | これらは必ず '''ファイル先頭''' に書かなければなりません(コメントや VBS の Option Explicit などよりも先)。 | ||
* <code>#title</code>は、マクロメニューやマクロバー、「ツールバーのカスタマイズ」に表示される '''マクロ名''' です(未指定の場合はファイル名の ****.js | * <code>#title</code>は、マクロメニューやマクロバー、「ツールバーのカスタマイズ」に表示される '''マクロ名''' です(未指定の場合はファイル名の ****.js で表示されます)。 | ||
* <code>#tooltip</code>は、マクロバーにマウスカーソルをあてたときにポップアップ表示される黄色い小窓(ヒント/ツールチップ/トースト)内の '''説明文''' | * <code>#tooltip</code>は、マクロバーにマウスカーソルをあてたときにポップアップ表示される黄色い小窓(ヒント/ツールチップ/トースト)内の '''説明文''' の文字列に使用されます。 | ||
* <code>#language</code>の詳細は、Mery.txt 内の更新履歴 『▼ 2018/03/22 (2.6.6)』 | * <code>#language</code>の詳細は、Mery.txt 内の更新履歴 『▼ 2018/03/22 (2.6.6)』 に記載されています。 | ||
=== 他のファイルのロード方法 === | === 他のファイルのロード方法 === | ||
マクロから他のファイルを直接ロードするには以下の方法があります。 | |||
* FileSystemObject を利用する | * FileSystemObject を利用する | ||
* ADODB.Stream を利用する | * ADODB.Stream を利用する | ||
| 94行目: | 94行目: | ||
==== FileSystemObject を利用する ==== | ==== FileSystemObject を利用する ==== | ||
コードが短く簡単に扱えます。 | |||
また FileSystemObject | また FileSystemObject 自体に、ファイルの有無やフォルダ作成の機能があります。 | ||
ただし扱える文字コードは SJIS または Unicode | ただし扱える文字コードは SJIS または Unicode 限定。 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
// Scripting.FileSystemObject の定数 | // Scripting.FileSystemObject の定数 | ||
| 123行目: | 123行目: | ||
==== ADODB.Stream を利用する ==== | ==== ADODB.Stream を利用する ==== | ||
書き方は若干複雑ですが、システムが対応している文字コードであれば全て扱えます。 | |||
また(信頼性は低いが)文字コードの自動判定も可能です。 | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
var adTypeBinary = 1; // バイナリ データを表します。 | var adTypeBinary = 1; // バイナリ データを表します。 | ||
| 155行目: | 155行目: | ||
==== include ライブラリの IO クラスを利用する ==== | ==== include ライブラリの IO クラスを利用する ==== | ||
ファイルの読み書きを簡単にするクラスです。 | |||
簡単に扱えることと、BOM なしの UTF-8 を書き込めることがメリットです。 | |||
逆にソースを読むしか資料がないこと、ユーザに導入してもらう必要があるのが欠点です。 | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
#include "include/IO.js" | #include "include/IO.js" | ||
| 172行目: | 172行目: | ||
=== 他のマクロの実行方法 === | === 他のマクロの実行方法 === | ||
他のマクロを実行するには、以下の方法があります。 | |||
* #include で取り込む | * #include で取り込む | ||
* ファイルをロードして eval する | * ファイルをロードして eval する | ||
前者は先頭でしかかけない上、動的にロードの切り替えができません。 | |||
後者は文字コードの問題とプリプロセス処理に関する問題があります。 | |||
include ライブラリの IO.Include | include ライブラリの IO.Include を使うことで、プリプロセス処理に関しては解決できます。 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
#include "include/IO.js" | #include "include/IO.js" | ||
| 187行目: | 187行目: | ||
=== マクロからファイル選択ダイアログ === | === マクロからファイル選択ダイアログ === | ||
できません。 | |||
2019/06/11追記 (有志): 以下の関数で可能です。 | 2019/06/11追記 (有志): 以下の関数で可能です。 | ||
| 244行目: | 244行目: | ||
=== Prompt で空入力とキャンセルの区別 === | === Prompt で空入力とキャンセルの区別 === | ||
できません。 | |||
=== PopupMenu.Add の ID === | === PopupMenu.Add の ID === | ||
PopupMenu.Add() の ID は必ず 0 | PopupMenu.Add() の ID は必ず 0 以外にしましょう。 | ||
PopupMenu.Track() | PopupMenu.Track() はキャンセルされた(メニューが押されなかった)場合、0 を返します | ||
スポンサーリンク