マクロリファレンス:3:ディレクティブのソースを表示

マクロのスクリプトでは必要に応じて、以下のディレクティブを使用できます。これらのディレクティブは必ずマクロファイルの先頭に記述してください。

==#title==
ツール バーのボタンに表示するタイトルの文字列を指定します。

;構文
<syntaxhighlight lang="javascript">
#title = "title"
</syntaxhighlight>

;例
ツール バーのボタンに [昇順で並べ替え] の文字列を表示します。
<syntaxhighlight lang="javascript">
#title = "昇順で並べ替え"
</syntaxhighlight>

==#tooltip==
ツール バーのボタンにマウスを乗せたときに表示されるヒントの文字列を指定します。

;構文
<syntaxhighlight lang="javascript">
#tooltip = "tooltip"
</syntaxhighlight>

;例
ツール バーのボタンにマウスを乗せたときに [昇順で並べ替えます] のヒントを表示します。
<syntaxhighlight lang="javascript">
#tooltip = "昇順で並べ替えます"
</syntaxhighlight>

==#begingroup==
[マクロ] メニューおよびマクロ バーの項目の手前に区切りバーを挿入します。

;構文
<syntaxhighlight lang="javascript">
#begingroup = true
</syntaxhighlight>

;例
[マクロ] メニューの項目の手前に区切り記号を挿入し、マクロ バーの項目の手前に区切りバーを挿入します。
<syntaxhighlight lang="javascript">
#begingroup = true
</syntaxhighlight>
[マクロ] メニューの項目の手前に区切り記号を挿入します。
<syntaxhighlight lang="javascript">
#begingroup = 2
</syntaxhighlight>
マクロ バーの項目の手前に区切りバーを挿入します。
<syntaxhighlight lang="javascript">
#begingroup = 3
</syntaxhighlight>

==#icon==
ツール バーのボタンに表示するアイコンを指定します。ファイルのパスは絶対パス、またはマクロファイルからの相対パスで指定します。

;構文
<syntaxhighlight lang="javascript">
#icon = "FileName", Index
</syntaxhighlight>

;例
エクスプローラーのアイコンを表示します。
<syntaxhighlight lang="javascript">
#icon = "C:\Windows\explorer.exe", 0
</syntaxhighlight>

==#icondark==
ダークモード有効時にツール バーのボタンに表示するアイコンを指定します。ファイルのパスは絶対パス、またはマクロファイルからの相対パスで指定します。

;構文
<syntaxhighlight lang="javascript">
#icondark = "FileName", Index
</syntaxhighlight>

;例
エクスプローラーのアイコンを表示します。
<syntaxhighlight lang="javascript">
#icondark = "C:\Windows\explorer.exe", 0
</syntaxhighlight>

==#include==
指定したファイルをマクロの先頭に含めます。ファイルのパスは絶対パス、またはマクロファイルからの相対パス、または Macros フォルダーからの相対パスで指定します。

;構文
<syntaxhighlight lang="javascript">
#include "FilePath"
</syntaxhighlight>

;例
sample.js を先頭に含めてマクロを実行します。
<syntaxhighlight lang="javascript">
#include "sample.js"
</syntaxhighlight>

==#language==
スクリプト言語を指定します。指定しない場合はマクロファイルの拡張子からスクリプト言語を自動で選択します。
;構文
<syntaxhighlight lang="javascript">
#language = "ScriptName"
</syntaxhighlight>

;例
JScript
<syntaxhighlight lang="javascript">
#language = "JScript"
</syntaxhighlight>
PerlScript
<syntaxhighlight lang="javascript">
#language = "PerlScript"
</syntaxhighlight>
PHPScript
<syntaxhighlight lang="javascript">
#language = "PHPScript"
</syntaxhighlight>
Python
<syntaxhighlight lang="javascript">
#language = "Python"
</syntaxhighlight>
RubyScript
<syntaxhighlight lang="javascript">
#language = "RubyScript"
</syntaxhighlight>
VBScript
<syntaxhighlight lang="javascript">
#language = "VBScript"
</syntaxhighlight>
拡張子 *.js で #language を指定しない場合、JavaScript エンジンとして Chakra (jscript9.dll) を使用します。#language = "JScript" を指定した場合は JavaScript エンジンとして JScript (jscript.dll) を使用します。実行速度は遅くなりますが、古い環境との互換性を優先する場合などにご利用ください。