【０】ここに書いてあること

　秀丸エディタの大きな魅力の一つに「秀丸マクロ」の存在があげられます。 マクロというのは、一種のプログラムで、これを利用することにより、秀丸エディタ上で行う作業を自動化したり、 秀丸エディタの機能を拡張したりと、秀丸エディタをより便利に使うことができます。 マクロは自分で作ってもよいし（実際、単純なマクロを組むのはそれほど難しいことではありません）、 人の作ったものをなんらかの方法で入手してもいいでしょう(注1)。 なお、手元に適当なマクロがない人は、【８】にサンプルのマクロをいくつか用意しておきましたので、 それを元に自分でマクロファイルを作って、いろいろ実行させてみましょう。(^_^)

　秀丸エディタのマクロの正体は、秀丸エディタのマクロ言語が記述された「MAC」という拡張子のついたテキストファイルです。 以下これをマクロファイルと呼びます。 ここでは、マクロ（マクロファイル）を入手してから、それを実際に利用するまでの手順を説明します。

注1:

例えば、以下の場所には、多くの秀丸エディタマクロが登録されています。

• 秀まるおさんのホームページのライブラリ (https://hide.maruo.co.jp/lib/index.html)
• Vector (https://www.vector.co.jp/vpack/filearea/win/writing/edit/hm/index.html)

【１】導入前の準備

　まず、このマクロファイルを格納するためのフォルダを作らなければなりません。

Windows Vista以降の場合、デフォルトではユーザーフォルダにある、 アプリケーションデータフォルダに設定されています。

    例) C:\Users\ユーザー名\AppData\Roaming\Hidemaruo\Hidemaru\Macro

ストアアプリ版の場合、マクロフォルダはドキュメントフォルダに設定されます。

    例) %USERPROFILE%\Documents\Hidemaru\StoreAppMacro

マクロフォルダはユーザーフォルダでなくてもかまいませんが、書き込み可能なフォルダを指定してください。 フォルダの名前は任意に指定可能です。(注2)

デフォルト以外の場所にマクロフォルダを作成した場合には、設定を変更する必要があります。 メニューの「その他 → 動作環境」で動作環境を開き、「環境」にある「パス」の「マクロファイル用のフォルダ」で設定を行います。

タイプミスをするといけないので[参照…]ボタンを押して、先ほど作成したフォルダを選択してください。 <OK>を選んで設定を終了します。<キャンセル>で終了すると、設定を変更したことにはならないので注意して下さい。

　これで作業は終了です。この作業は最初に１回だけやる必要があります。 マクロ用フォルダの名前や場所を変えない限り、この作業をやりなおす必要はありません。

ストアアプリ版では「環境変数」を含むパスが設定されますが、デスクトップ版でもパスに「環境変数」を含めることは可能です。(Ver.8.40以降)
デフォルト設定の場合、環境変数を使った場合は、以下のようになります。

    例) %APPDATA%\Hidemaruo\Hidemaru\Macro

「環境変数」を含める利点は、「設定内容の保存/復元」を使い保存し、別環境で復元するという作業がやりやすいことです。 直接フルパスで記入した場合、Windowsのログオンユーザー名なども含め同じでない場合は、必ず設定の変更が必要になりますが、 環境変数を使えば、ログオンユーザー名などは環境変数に含まれるため、設定の変更は不要です。
(環境変数が使えるのは、マクロ用と設定用のフォルダ指定です。すべてのパス設定で環境変数が使えるわけではない為、 何も設定変更しなくても良いというわけでは、ありません。)

注2

Windows Vista以降のOSは、通常の権限では"OSに保護された領域"にファイルの書き込みが出来ません(管理者権限に昇格が必要)。 秀丸エディタのデフォルトインストール先は、"C:\Program Files\Hidemaru"ですが、 "C:\Program Files"以下は、"OSに保護された領域"となるので、マクロフォルダの作成には向いていません。 (64bit OSで、32bit版秀丸エディタを使っている場合、インストール先は"C:\Program Files(x86)\Hidemaru"になり、 ここも保護されたフォルダになります。)

デフォルトマクロフォルダが指定されているユーザーフォルダは、エクスプローラでも見えないような設定になっています(OS側の設定)。 見えるようにするにはOSの設定を変更する必要があります。 (「フォルダーオプション」の「隠しファイル、隠しフォルダー、および隠しドライブを表示する」を選ぶ。)

OS側の設定を変更したくない場合は、ユーザーフォルダ以外にマクロフォルダを作成する必要があります。

秀丸エディタの仕様ではマクロ用のフォルダは必ずしも準備しなくてもいいことになっていますが、 Windows Vista以降のOSでは、必ず指定するようにしてください。 空欄だと、秀丸エディタ本体と同じ場所を指定した事になってしまいます。

【２】個々のマクロの導入（前提：【１】）

　データライブラリに登録されているマクロの場合は LHAやZIP形式で圧縮されている場合がほとんどですから、 マクロ用フォルダに展開（解凍）します。 またドキュメント以外の添付ファイルがある場合、それらの中にはマクロの実行に必要なものが含まれている可能性があります。 ドキュメント等をよく読んでその指示に従って下さい。

【３】一番原始的なマクロの実行（前提：【１】【２】）

ダイアログの中に、【１】でマクロ用フォルダに含まれるマクロファイルのリストが表示されますから、 その中から実行したいマクロファイルを選び、ファイル名のテキストボックスの中にそのファイル名が表示されたのを確認してから <OK>をクリックします。これで、そのマクロが実行されます。

マクロ実行ダイアログは変更可能です。 「動作環境 − 環境 − 高度な環境 − マクロ実行ダイアログ」で設定します。

「参照ダイアログ」の場合、ファイル選択ダイアログが開きます。 マクロをフォルダで分類しているような場合には、こちらのダイアログの方が便利でしょう。

【４】マクロ登録（前提：【１】【２】）

　まず「マクロ→マクロ登録」で「マクロ登録」ダイアログを呼び出します。 マクロ登録では「マクロ1」から「マクロ80」まで８０個のマクロを登録することができます。 これらは「１〜１０」「１１〜２０」という風に１０個づつのグループになっています。 ダイアログの左側にある「対象」で、これらを切り替えることができます。

　「１〜１０」グループに登録したマクロは、「マクロ」のプルダウンメニューの中にタイトルが表示され、 そこから直接起動することができます。 「１１〜２０」グループ以降に登録したものは、プルダウンメニューの中にグループ名が表示されます。 グループ名を選択すると、該当するグループに登録されたマクロのタイトルのメニューが表示され、 そこからマクロを起動することができます。

メニューの「マクロ」を開いたところ

マクロ登録ダイアログは、バージョンにより異なります。

• Ver.8.79以降
• Ver.8.77まで

Ver.8.79以降

Ver.8.79からは、ダイアログが変更されています。
追加したい場所を選択後、画面下段にあるタイトルとファイル名の入力欄で、各項目を入力します。
ファイル名右側の「＞」ボタンでリストが出ます。 「…」ボタンで、ファイル参照ダイアログを使って、マクロファイルを選択することも可能です。

エクスプローラからのドロップにも対応していて、マクロをエクスプローラから登録したい箇所にドロップすれば、 タイトルとファイル名が設定されます。 タイトルはファイル名から拡張子を削除したものが自動にセットされるので、必要に応じて変更してください。
右下の「開く」ボタンを押すと、エクスプローラでマクロフォルダが開きます。

ドロップ中に、グループの切替は出来ないので、あらかじめ登録したいグループ選択しておいてください。 とりあえずドロップし、移動したい項目を選択後、「上へ」、「下へ」のボタンで、移動する事も出来ます。 (「上へ」、「下へ」のボタンは、グループを超えて移動できます。)

Ver.8.79以降のマクロ登録ダイアログ(左下の「モード」から旧ダイアログにも変更可能です。キー割り当ても表示できます。)

Ver.8.77まで

マクロ登録の基本は「タイトル」と「ファイル名」の指定です。 まず「ファイル名」の欄に、セットアップしたマクロファイルの名前を入力します。 右側の「＞」ボタンでリストが出ます。 「…」ボタンで、ファイル参照ダイアログを使って、マクロファイルを選択することも可能です。

次に、任意の「タイトル名」を入力します。このタイトルがプルダウンメニュー等に表示されますので、 マクロの機能がすぐにわかるような名前を付けましょう。

Ver.8.77までの画面

グループが「１〜１０」以外の場合は上にある「グループ名」の欄にも任意の名前を入力して下さい(注3)。 作業が終わったらをクリックしてマクロ登録を終了します。

注3

ここでグループ名を入力しないと、プルダウンメニューにグループ名が表示されません。 また、「１〜１０」グループにはグループ名は付けられません。

【５】ショートカットキーへの登録（前提：【１】【２】【４】）

　マクロ登録後、プルダウンメニューを見ると、「マクロ1」から「マクロ9」に登録したものは、 それぞれ右側に「Ctrl+1」などと表示されています。 これは「文章を入力・編集しているときに、[CTRL]を押しながら[1]を押すと、マクロ1が実行される」という意味です。 つまり「マクロ1」から「マクロ9」に登録したマクロは、（何番に何のマクロが登録されているかを憶えてさえいれば） 実はプルダウンメニューを表示させなくても呼び出すことができるのです(注4)。 このような特定のキーの組み合わせによって、メニューなどを介さずに直接コマンドなどを実行する機能（およびそのキーの組み合わせ）のことを 一般に「ショートカットキー」といいます。

　まず「その他→キー割り当て」でキー割り当てのダイアログを呼び出します。

左側の「キー」のリストには割り当てることのできるキー（すでにコマンドが割り当てられているキーを含む）の一覧が表示されます。 このキーリストの内容は、その下の「Shift/Ctrl/Alt/キー割り当て拡張」のチェックとの組み合わせで変化します。

　キーリストの中から、あるキーの組み合わせを選ぶ（クリックする）と、そのキーに登録されているコマンドが、 中央の「コマンド」のリストの中で選択表示されます。 「(なし)」が選択表示されている場合、そのキーにはまだコマンドが割り当てられていないということです。 コマンド系列ボックス右側の「↓」で表示されるリストからコマンド系列を選び、 その下のコマンドリストに表示されたコマンドの一つをクリックして選択表示させることにより、 左側で指示したキーに割り当てるコマンドを変更（あるいは新規に設定）することができます。(注5)

　マクロを設定する場合は、キー選択後、コマンドを選択する際に、「メニュー/マクロ」の系列を選び、 コマンドリスト中の「マクロ1」から「マクロ50」の中から割り当てたいものをクリックします。

例えば「[Ctrl]と[Shift]を押しながら[C]→マクロ15（に登録したマクロ） を実行」と設定したい場合、 まず右下の

• ☐Shift(S)
• ☐Ctrl(T)

をチェック（クリックして☐の中に☑がついた状態にする）し、 次にキーリストをスクロールさせて「Shift+Ctrl+C」をクリックして選択状態にし、 次に右上で「メニュー/マクロ」の系列を選んでから、コマンドリストをスクロールさせて「マクロ15:×××××」をクリックすることになります。

　<OK>をクリックして終了すると、登録したキー割り当てが有効になります。

注4：

Ctrl+1〜Ctrl+9のキー割り当ては「マクロ1」〜「マクロ9」に固定されているようです。 もちろんこれらのマクロを別のキーに「も」割り当てることは問題なくできます。

注5：

順番に注意して下さい。必ず左側で「キー」を選んだ後に、右側で「コマンド」を選ばなければなりません。

【６】ツールバーからマクロ起動（前提：【１】【２】【４】）

　まず「その他→動作環境→ウィンドウ」の「☐ツールバー」の項目がチェックされていなかったら、これをチェックします。 さらに[詳細]ボタンをクリックし、「ツールバー詳細」のダイアログを呼び出します。 右側のボックスでコマンド系列に「メニュー/マクロ系」を指定すると、その下のリストに「マクロ1」から「マクロ10」までの（数字のデザインの） アイコンが表示されます。(11〜80まではアイコンがありません。) これらは「マクロ登録」で「マクロ1」〜「マクロ80」に割り当てたマクロに対応していますから、 適宜選んで中央の[追加]ボタンをクリックすると、左側のツールバーリストの最後尾に追加されます。 アイコンの並びは[一つ上に][一つ下に]ボタンで調整します。作業が終わったら<OK>ボタンで終了します。

　これで、メニューの下のツールバーの数字のアイコンから直接マクロを起動できるようになります。

【７】ユーザーメニューからマクロ起動（前提：【１】【２】【４】）

　まずメニューの編集をします。「その他→メニュー編集」で「メニューの編集」のダイアログを呼び出し、 「ユーザーメニュー」のタブを選択します。 「メニュー」欄で編集するメニューを選択すると、そのメニューの現在の内容が「内容」のリストに表示されます。

[追加…]ボタンで「追加」ダイアログを呼び出します。

コマンド系列に「メニュー/マクロ」を指定すると、下のリストに「マクロ1」から「マクロ80」までが表示されます(注6)。 メニューに追加したいものをクリックして選択表示させ、「キー」欄に半角英数字１文字を入力します （この半角英数字はメニュー内での一種のショートカットキーになります）。 ここで[追加]をクリックすると、「ユーザーメニューの設定」ダイアログに戻るので、 「内容」リストの末尾に先ほど指定したマクロが追加されていることを確認して下さい。 必要なら並べ替え等をし、[閉じる]で終了します。これでメニューの編集は終わりです。

　「メニュー1」から「メニュー8」の場合、次にメニューのキー割り当てをします(注7)。 要領は【５】とほぼ同じです。違うのはコマンドリストから選ぶのが「マクロ」ではなく「メニュー」であるということだけです。

　これで、割り当てられたショートカットキーによりユーザーメニューが表示され、その中からマクロを実行できるようになります。

注6：

実際にはこのリスト中にはユーザーメニューも含まれています。 これを「追加」するとユーザーメニューの中にユーザーメニューを登録することになります。 これによりユーザーメニューを階層化することができるようです。

注7：

「選択中右ボタン」に限り、「範囲選択中のマウス右クリック」に対応が固定されていますので、 キー割り当ての作業は不要です（というかできません）。 また、デフォルトの設定では「メニュー1」が「右クリック」に割り当てられているようです（キー割り当てのダイアログで確認できます）。 したがってマウスの右クリックメニューからマクロを実行したい場合は、さしあたって「メニュー1」および「選択中右ボタン」に 登録するのが簡単でしょう。こうすればキー割り当てで悩む必要はありません。 特に「処理範囲を選択してから実行するマクロ」の場合、「選択中右ボタン」に登録しておくと、 マウスの左ボタンドラッグで範囲を選択した後、右クリックでメニューを出して、すぐにマクロを実行できるので便利です。

【８】サンプルマクロ

1. 以下のサンプルの中から好きなものを心に決める。(^_^)
2. Ｑ＆Ａ集のウィンドウのメニューの「編集→コピー」を選択する。（多少時間がかかるかもしれません。）
3. 心に決めたサンプルの「//―ここから」と「//―ここまで」で挟まれた部分をドラッグして選択し「一部分コピー」をクリックする。
4. 秀丸エディタを起動し （あるいは「ファイル→新規作成」でまっさらな秀丸エディタを用意し）「編集→貼り付け」で先ほどコピーしたものを秀丸エディタにペーストする。
5. 「ファイル→名前を付けて保存」を選び、下記の名前をつけてマクロ用フォルダ（【１】参照）に保存する。

//---ここから
//QA_SMPL1.MAC
insert date + " " + time;
endmacro;
//---ここまで

//---ここから
//QA_SMPL2.MAC
gofileend;
insert "\n" + "自分の名前" + "\n";
endmacro;
//---ここまで

//---ここから
//QA_SMPL3.MAC
gofileend;
replaceup "^\\n\\n+", "\n", regular;
while (result) findup;
endmacro;
//---ここまで

//---ここから
//QA_SMPL4.MAC
replaceall "^[ 　\\t]+$","", regular;
endmacro;
//---ここまで