「マクロ覚え書き(開発者向け)」の版間の差分
ハイライト効果の適用 |
改行とマークアップの修正 |
||
| 1行目: | 1行目: | ||
== 概要 == | == 概要 == | ||
マクロ開発者向けの覚え書きです. | マクロ開発者向けの覚え書きです. | ||
リファレンスなどに載っていない,豆知識的なことを集めています. | リファレンスなどに載っていない,豆知識的なことを集めています. | ||
== 覚え書き == | == 覚え書き == | ||
=== 開発言語について === | === 開発言語について === | ||
WSH(Windows Script Host) が対応している言語であれば利用が可能です. | WSH(Windows Script Host) が対応している言語であれば利用が可能です. | ||
標準では JScript(≒javascript)と VBScript が入っています. | |||
他の言語(Perl や Python)もインストールすれば使えますが,一般配布する場合利用者もインストールが必要になります. | 標準では JScript(≒javascript)と VBScript が入っています. | ||
他の言語(Perl や Python)もインストールすれば使えますが,一般配布する場合利用者もインストールが必要になります. | |||
どの言語でも良いですが,JScript での開発者が多いため,JScript の方が情報が集まりやすくお勧めです. | どの言語でも良いですが,JScript での開発者が多いため,JScript の方が情報が集まりやすくお勧めです. | ||
=== マクロを保存する際の文字コード === | === マクロを保存する際の文字コード === | ||
基本的に単体で利用する場合はどの文字コードでも構いません. | 基本的に単体で利用する場合はどの文字コードでも構いません. | ||
ただし「他のマクロから読まれる」場合は文字コードの選択が重要になります. | |||
今のマクロでは #title のようなプリプロセス処理が必要で,それに対応したロードができる include ライブラリの IO.Include はデフォルトで UTF-8 対応なので,UTF-8 をお勧めします(個別の指定は可能). | ただし「他のマクロから読まれる」場合は文字コードの選択が重要になります. | ||
今のマクロでは #title のようなプリプロセス処理が必要で,それに対応したロードができる include ライブラリの IO.Include はデフォルトで UTF-8 対応なので,UTF-8 をお勧めします(個別の指定は可能). | |||
ただし読み込む側が FileSystemObject を利用している場合,SJIS/Unicode しか対応できないのでその場合は SJIS をお勧めします(Mery 1 時代のマクロなどはコレです). | ただし読み込む側が FileSystemObject を利用している場合,SJIS/Unicode しか対応できないのでその場合は SJIS をお勧めします(Mery 1 時代のマクロなどはコレです). | ||
=== window.Document と Editor.ActiveDocument の違い === | === window.Document と Editor.ActiveDocument の違い === | ||
window.Document は,マクロ開始時にアクティブなドキュメントを指し続けます.マクロで別のドキュメントを Activate しても変わりません. | window.Document は,マクロ開始時にアクティブなドキュメントを指し続けます.マクロで別のドキュメントを Activate しても変わりません. | ||
Editor.ActiveDocument は,その時点でアクティブなドキュメントを指します.マクロで別のドキュメントを Activate すると当然変わります. | Editor.ActiveDocument は,その時点でアクティブなドキュメントを指します.マクロで別のドキュメントを Activate すると当然変わります. | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 48行目: | 56行目: | ||
=== 矩形選択の扱い === | === 矩形選択の扱い === | ||
マクロで矩形選択は扱えません(プラグインですら無理). | マクロで矩形選択は扱えません(プラグインですら無理). | ||
ただし,矩形選択中かの判定だけは以下の方法で可能です. | ただし,矩形選択中かの判定だけは以下の方法で可能です. | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 60行目: | 69行目: | ||
=== Document.GetLines の引数 === | === Document.GetLines の引数 === | ||
リファレンスには '''meGetLineView''' しか書かれていませんが,論理行単位での行数取得には引数に 0 を渡します. | リファレンスには '''meGetLineView''' しか書かれていませんが,論理行単位での行数取得には引数に 0 を渡します. | ||
'''meGetLineLogical''' という定数はありません. | '''meGetLineLogical''' という定数はありません. | ||
| 69行目: | 79行目: | ||
* <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] (スクリプトの言語を指定. ※[https://www.haijin-boys.com/software/mery/mery-2-6-7#9 省略時は "JScript(Chakra)"]) | * <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 の数値. ※Mery 2.8.0 以降のみ) | * <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>#tooltip</code>は、マクロバーにマウスカーソルをあてたときにポップアップ表示される黄色い小窓(ヒント/ツールチップ/トースト)内の '''説明文''' の文字列に使用されます. | |||
* <code>#language</code>の詳細は、Mery.txt 内の更新履歴 『▼ 2018/03/22 (2.6.6)』 に記載されています. | |||
=== 他のファイルのロード方法 === | === 他のファイルのロード方法 === | ||
| 85行目: | 94行目: | ||
==== FileSystemObject を利用する ==== | ==== FileSystemObject を利用する ==== | ||
コードが短く簡単に扱えます. | コードが短く簡単に扱えます. | ||
また FileSystemObject 自体に,ファイルの有無やフォルダ作成の機能があります. | |||
また FileSystemObject 自体に,ファイルの有無やフォルダ作成の機能があります. | |||
ただし扱える文字コードは SJIS または Unicode 限定. | ただし扱える文字コードは SJIS または Unicode 限定. | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 112行目: | 123行目: | ||
==== ADODB.Stream を利用する ==== | ==== ADODB.Stream を利用する ==== | ||
書き方は若干複雑ですが,システムが対応している文字コードであれば全て扱えます. | 書き方は若干複雑ですが,システムが対応している文字コードであれば全て扱えます. | ||
また(信頼性は低いが)文字コードの自動判定も可能です. | また(信頼性は低いが)文字コードの自動判定も可能です. | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 143行目: | 155行目: | ||
==== include ライブラリの IO クラスを利用する ==== | ==== include ライブラリの IO クラスを利用する ==== | ||
ファイルの読み書きを簡単にするクラスです. | ファイルの読み書きを簡単にするクラスです. | ||
簡単に扱えることと,BOM なしの UTF-8 を書き込めることがメリットです. | |||
簡単に扱えることと,BOM なしの UTF-8 を書き込めることがメリットです. | |||
逆にソースを読むしか資料がないこと,ユーザに導入してもらう必要があるのが欠点です. | 逆にソースを読むしか資料がないこと,ユーザに導入してもらう必要があるのが欠点です. | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 161行目: | 175行目: | ||
* #include で取り込む | * #include で取り込む | ||
* ファイルをロードして eval する | * ファイルをロードして eval する | ||
前者は先頭でしかかけない上,動的にロードの切り替えができません. | 前者は先頭でしかかけない上,動的にロードの切り替えができません. | ||
後者は文字コードの問題とプリプロセス処理に関する問題があります. | |||
後者は文字コードの問題とプリプロセス処理に関する問題があります. | |||
include ライブラリの IO.Include を使うことで,プリプロセス処理に関しては解決できます. | include ライブラリの IO.Include を使うことで,プリプロセス処理に関しては解決できます. | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 171行目: | 187行目: | ||
=== マクロからファイル選択ダイアログ === | === マクロからファイル選択ダイアログ === | ||
できません. | できません. | ||
2019/06/11追記 (有志): 以下の関数で可能です。 | 2019/06/11追記 (有志): 以下の関数で可能です。 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 197行目: | 214行目: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
使用例 | 使用例 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 202行目: | 220行目: | ||
window.alert((filename)?filename:'Canceled'); | window.alert((filename)?filename:'Canceled'); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
2019/06/17追記 (有志): PoserShell 版追加,, 2019/06/19 修正: Exec と標準出力の組み合わせを、Runとクリップボードに変更 | |||
2019/06/17追記 (有志): PoserShell 版追加,, 2019/06/19 修正: Exec と標準出力の組み合わせを、Runとクリップボードに変更 | |||
HtmlDlgHelper.object.openfiledlg の第1引数はダイアログに初期表示する InitFile。疑似的に初期フォルダを指定することが可能だが、パス区切り文字 "\" で終わることはできない。PowerShell 版なら初期フォルダの明示、複数ファイル選択が可能。Multiselect = $false にしても $dialog.FileName に書き換えせずに $dialog.FileNames でアクセス可能。 | HtmlDlgHelper.object.openfiledlg の第1引数はダイアログに初期表示する InitFile。疑似的に初期フォルダを指定することが可能だが、パス区切り文字 "\" で終わることはできない。PowerShell 版なら初期フォルダの明示、複数ファイル選択が可能。Multiselect = $false にしても $dialog.FileName に書き換えせずに $dialog.FileNames でアクセス可能。 | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| 227行目: | 247行目: | ||
=== PopupMenu.Add の ID === | === PopupMenu.Add の ID === | ||
PopupMenu.Add() の ID は必ず 0 以外にしましょう. | PopupMenu.Add() の ID は必ず 0 以外にしましょう. | ||
PopupMenu.Track() はキャンセルされた(メニューが押されなかった)場合,0 を返します | PopupMenu.Track() はキャンセルされた(メニューが押されなかった)場合,0 を返します | ||
スポンサーリンク