「利用者:Sukemaru」を編集中 (節単位)

=== イベントマクロ ===
; [[ヘルプ:マクロ#カスタマイズ|イベントマクロ]] を実行できる "イベント" の種類
: <b style="color:#c00;">赤字</b> は遅延時間を設定できるイベント
{|class="wikitable"
!フォーカスを受け取った時
| エディタのウインドウがアクティブになったとき。<br> ・｢オプション｣ などモーダルなダイアログからの復帰時には発動しない<br> ・<code>Editor.ActiveDocument == Document</code>
|-
!フォーカスを失った時
| エディタのウインドウがアクティブでなくなったとき。<br> ・｢検索｣ ｢置換｣ ダイアログを開いたときにも発動する…<br> ・<code>Editor.ActiveDocument != Document</code>
|-
!ファイルを開いた時
| 複数ファイルをまとめて開いたときは、すべて開いたあとに１回だけ。<br> ・複数ファイルをまとめて開いたときには、さいごのタブにしか作用しない
|-
!ファイルを保存した時
| 複数ファイルをまとめて保存したときは、すべて保存したあとに１回だけ。
|-
!更新状態が変更された時
| ｢保存済み｣ 状態から ｢未保存*｣ 状態になったときに発動した。
|-
!<span style="color:#c00;">カーソルが移動した時</span>
| キャレット位置が動いたとき。<br> ・<span style="color:#c00;">'''遅延''' を大きく設定しないと、すごくジャマ</span>
|-
!<span style="color:#c00;">スクロールした時</span>
| エディタウインドウをスクロールしたとき。<br> ・マウスホイール操作やスクロールバーの操作、<br>　PgUp / PgDn / Home / End キーなどでスクロールさせたとき <br> ・文字入力中や、矢印キーなどでのキャレット移動にともなうスクロールでは発動しない
|-
!<span style="color:#c00;">選択範囲が変更された時</span>
| 範囲選択したときと、選択範囲を解除したとき。<br> ・<span style="color:#c00;">'''遅延''' を大きく設定しないと、ドラッグ操作や Shift＋矢印キーで範囲選択するときにジャマ</span>
|-
!<span style="color:#c00;">テキストが変更された時</span>
| 入力･削除･置換などの編集操作をしたとき。<br> ・<span style="color:#c00;">'''遅延''' を大きく設定しないと、すごくジャマ</span>
|-
!<span style="color:#c00;">文字が挿入された時</span>
| 文字数が増えたとき？<br> ・選択範囲文字列の [ Ctrl＋ドラッグ ] による複製や、 <br>　クリップボードからのペースト、<br>　マクロの <code>Document.Write( "hoge" )</code> や <br>　<code>Document.Selection.Text = "hoge"</code> では発動しないようだった <br> ・<span style="color:#c00;">'''遅延''' を大きく設定しないと、すごくジャマ</span>
|-
!編集モードが変更された時
| 編集モードを変更したとき。<br> ・マクロで編集モードを変更したときも
|-
!アクティブな文書が変更された時
| 別のタブをアクティブにした後に発動。<br> ・タブを閉じた後や、新規タブを開いたときにも
|-
!文書を閉じた時
| 複数のタブをまとめて閉じたときは、すべて閉じたあとに１回だけ。<br> ・最後のタブが閉じてエディタウインドウが終了する場合は発動しない
|-
!タブを移動した時
| タブをドラッグ＆ドロップ操作で動かしたとき。<br> ・左側のタブを閉じて右側のタブが動いた場合には発動しない
|-
!アイドル状態になった時
| (不明)
|-
!ファイルを保存する前
|ファイルを保存する前。
|}

: ※ 複数のイベントマクロで <b style="color:#c00;">各赤字イベント</b> の遅延時間の設定は共有されるので、同じイベントに複数のマクロを割りあてている場合にマクロの発動の順序を恣意的に指定することはできない。
:: → マクロのコードを統合するか、イベントを設定するマクロをひとつだけにして [[マクロ覚え書き（開発者向け）#他のマクロの実行方法|include]] で別のマクロを発動させることができる。
: ※ イベントマクロ であっても、ショートカットキーなどから任意のタイミングで強制的に実行することもできる。
: ※ イベントマクロでない「マクロA」のコードでファイルを 開く または 閉じる をおこない、それ以降にも「マクロA」のコードが続いている場合は、ファイルを開いた時／閉じた時の「イベントマクロB」は発動しないことがある。

* sukemaru の Mery では、「[[バイト数#バイト数と文字数・行数|バイト数]]」マクロと「[[検索ヒット数表示（選択文字列）]]」マクロの機能を統合した「[[検索ヒット数表示（選択文字列）#機能強化バージョン|文字数・行数・バイト数・ヒット件数]]」マクロに「ファイルを開いた時」「<span style="color:#c00;">選択範囲が変更された時</span>」「<span style="color:#c00;">テキストが変更された時</span>」「<span style="color:#c00;">文字が挿入された時</span>」「アクティブな文書が変更された時」イベントを設定している（<span style="color:#c00;">赤字</span> の各イベントには遅延時間を 1 秒に設定。 ロースペックな PC ゆえ、一定以上の長さのファイル／タブにおいては機能を制限してある）。
** 遅延時間が短すぎると、"文字列や選択範囲を変更するような他のマクロの実行後に、そのマクロからのステータスメッセージが読めなくなるから"、という意味もある。
* また、「[[編集モードの自動選択#sukemaru 版２（include版）|編集モードの自動選択 (include版)]]」マクロを「ファイルを開いた時」「文書を閉じた時」イベントに、[[編集モードの自動選択#サブマクロ|補助マクロ]] を「ファイルを保存した時」イベントに設定して、それなりに按配よく運用できている。
** （[[includeライブラリ]] を利用して、複数のファイルを開いたときにもそれぞれのタブにたいして編集モードの変更や書き換え禁止を適用できるようにしてある）