「マクロ覚え書き(開発者向け)」の版間の差分

MSY-07 (トーク | 投稿記録)
ハイライト効果の適用
MSY-07 (トーク | 投稿記録)
改行とマークアップの修正
1行目: 1行目:
== 概要 ==
== 概要 ==
マクロ開発者向けの覚え書きです.<br>
マクロ開発者向けの覚え書きです.
 
リファレンスなどに載っていない,豆知識的なことを集めています.
リファレンスなどに載っていない,豆知識的なことを集めています.


== 覚え書き ==
== 覚え書き ==
=== 開発言語について ===
=== 開発言語について ===
WSH(Windows Script Host) が対応している言語であれば利用が可能です.<br>
WSH(Windows Script Host) が対応している言語であれば利用が可能です.
標準では JScript(≒javascript)と VBScript が入っています.<br>
 
他の言語(Perl や Python)もインストールすれば使えますが,一般配布する場合利用者もインストールが必要になります.<br>
標準では JScript(≒javascript)と VBScript が入っています.
 
他の言語(Perl や Python)もインストールすれば使えますが,一般配布する場合利用者もインストールが必要になります.
 
どの言語でも良いですが,JScript での開発者が多いため,JScript の方が情報が集まりやすくお勧めです.
どの言語でも良いですが,JScript での開発者が多いため,JScript の方が情報が集まりやすくお勧めです.


=== マクロを保存する際の文字コード ===
=== マクロを保存する際の文字コード ===
基本的に単体で利用する場合はどの文字コードでも構いません.<br>
基本的に単体で利用する場合はどの文字コードでも構いません.
ただし「他のマクロから読まれる」場合は文字コードの選択が重要になります.<br>
 
今のマクロでは #title のようなプリプロセス処理が必要で,それに対応したロードができる include ライブラリの IO.Include はデフォルトで UTF-8 対応なので,UTF-8 をお勧めします(個別の指定は可能).<br>
ただし「他のマクロから読まれる」場合は文字コードの選択が重要になります.
 
今のマクロでは #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 しても変わりません.<br>
window.Document は,マクロ開始時にアクティブなドキュメントを指し続けます.マクロで別のドキュメントを Activate しても変わりません.
 
Editor.ActiveDocument は,その時点でアクティブなドキュメントを指します.マクロで別のドキュメントを Activate すると当然変わります.
Editor.ActiveDocument は,その時点でアクティブなドキュメントを指します.マクロで別のドキュメントを Activate すると当然変わります.
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
48行目: 56行目:


=== 矩形選択の扱い ===
=== 矩形選択の扱い ===
マクロで矩形選択は扱えません(プラグインですら無理).<br>
マクロで矩形選択は扱えません(プラグインですら無理).
 
ただし,矩形選択中かの判定だけは以下の方法で可能です.
ただし,矩形選択中かの判定だけは以下の方法で可能です.
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
60行目: 69行目:


=== Document.GetLines の引数 ===
=== Document.GetLines の引数 ===
リファレンスには '''meGetLineView''' しか書かれていませんが,論理行単位での行数取得には引数に 0 を渡します.<br>
リファレンスには '''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 などよりも先).<br>
これらは必ず '''ファイル先頭''' に書かなければなりません(コメントや 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)』 に記載されています.


=== 他のファイルのロード方法 ===
=== 他のファイルのロード方法 ===
85行目: 94行目:


==== FileSystemObject を利用する ====
==== FileSystemObject を利用する ====
コードが短く簡単に扱えます.<br>
コードが短く簡単に扱えます.
また FileSystemObject 自体に,ファイルの有無やフォルダ作成の機能があります.<br>
 
また FileSystemObject 自体に,ファイルの有無やフォルダ作成の機能があります.
 
ただし扱える文字コードは SJIS または Unicode 限定.
ただし扱える文字コードは SJIS または Unicode 限定.
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
112行目: 123行目:


==== ADODB.Stream を利用する ====
==== ADODB.Stream を利用する ====
書き方は若干複雑ですが,システムが対応している文字コードであれば全て扱えます.<br>
書き方は若干複雑ですが,システムが対応している文字コードであれば全て扱えます.
 
また(信頼性は低いが)文字コードの自動判定も可能です.
また(信頼性は低いが)文字コードの自動判定も可能です.
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
143行目: 155行目:


==== include ライブラリの IO クラスを利用する ====
==== include ライブラリの IO クラスを利用する ====
ファイルの読み書きを簡単にするクラスです.<br>
ファイルの読み書きを簡単にするクラスです.
簡単に扱えることと,BOM なしの UTF-8 を書き込めることがメリットです.<br>
 
簡単に扱えることと,BOM なしの UTF-8 を書き込めることがメリットです.
 
逆にソースを読むしか資料がないこと,ユーザに導入してもらう必要があるのが欠点です.
逆にソースを読むしか資料がないこと,ユーザに導入してもらう必要があるのが欠点です.
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
161行目: 175行目:
* #include で取り込む
* #include で取り込む
* ファイルをロードして eval する
* ファイルをロードして eval する
前者は先頭でしかかけない上,動的にロードの切り替えができません.<br>
前者は先頭でしかかけない上,動的にロードの切り替えができません.
後者は文字コードの問題とプリプロセス処理に関する問題があります.<br>
 
後者は文字コードの問題とプリプロセス処理に関する問題があります.
 
include ライブラリの IO.Include を使うことで,プリプロセス処理に関しては解決できます.
include ライブラリの IO.Include を使うことで,プリプロセス処理に関しては解決できます.
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
171行目: 187行目:


=== マクロからファイル選択ダイアログ ===
=== マクロからファイル選択ダイアログ ===
できません.<BR>
できません.
 
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とクリップボードに変更<br>
 
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 以外にしましょう.<br>
PopupMenu.Add() の ID は必ず 0 以外にしましょう.
 
PopupMenu.Track() はキャンセルされた(メニューが押されなかった)場合,0 を返します
PopupMenu.Track() はキャンセルされた(メニューが押されなかった)場合,0 を返します
スポンサーリンク