Sukemaru (トーク | 投稿記録)
Sukemaru (トーク | 投稿記録)
編集の要約なし
113行目: 113行目:


= マクロ覚え書き =
= マクロ覚え書き =
; リンク
 
* マクロライブラリにある ks 氏らの「[[マクロ覚え書き(開発者向け)|マクロ覚え書き]]」
== リンク ==
* 黄身氏の「[[利用者:黄身#覚え書き|覚え書き]]」
* [[マクロライブラリ#その他|マクロライブラリ]] にある ks 氏らの「[[マクロ覚え書き(開発者向け)|マクロ覚え書き]]」
<br>
* 黄身氏の「[[利用者:黄身#覚え書き|覚え書き]]」 <br>
* [[マクロリファレンス]]
* MeryWiki の [[マクロリファレンス]]
* Mery [https://www.haijin-boys.com/discussions 公式フォーラム]
* [https://www.haijin-boys.com/discussions Mery 公式フォーラム] <br>
* MDN web docus(mozzila)の [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference JavaScript リファレンス]
* MDN web docus(mozzila)の [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference JavaScript リファレンス] <br>
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc392483(v=msdn.10) Microsoft Windows スクリプト テクノロジ]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc409859%28v%3dmsdn.10%29 JScript ランゲージ リファレンス]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc409859%28v%3dmsdn.10%29 JScript ランゲージ リファレンス]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364460(v=msdn.10) WSH リファレンス]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364460(v=msdn.10) WSH リファレンス]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc427968%28v%3dmsdn.10%29 FileSystemObject リファレンス]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc427968%28v%3dmsdn.10%29 FileSystemObject リファレンス]
<br><br>
<br><br>
拙作マクロはポップアップメニューを利用するものが多いので、Tips はその方面の内容に偏ってしまいますが、個人的に注意していることや気付いたことなど…。
----
拙作マクロはポップアップメニューを利用するものが多いので、Tips はその方面の内容に偏ってしまいますが、以下、個人的に注意していることや気付いたことなど…。




131行目: 133行目:
しかし、[[マクロリファレンス:Document インターフェイス|Document]] オブジェクトのかわりに [[マクロリファレンス:Editor インターフェイス#ActiveDocument プロパティ|Editor.ActiveDocument]] で記述したマクロであれば、エディタ領域にフォーカスがない場合でもツールバーアイコンやマクロメニューからマクロを起動できる。
しかし、[[マクロリファレンス:Document インターフェイス|Document]] オブジェクトのかわりに [[マクロリファレンス:Editor インターフェイス#ActiveDocument プロパティ|Editor.ActiveDocument]] で記述したマクロであれば、エディタ領域にフォーカスがない場合でもツールバーアイコンやマクロメニューからマクロを起動できる。
<br><br>
<br><br>
※ ただし、アクティブなタブ以外を操作・編集するマクロにおいては Editor.Documents.Item( dd ) などのような記述が必要。
※ ただし、アクティブなタブ以外を操作・編集するマクロにおいては ''Editor.Documents.Item( dd )'' などのような記述が必要。
<br><br>
<br><br>
マクロをツールバー/マクロバーから使用するために [[マテリアルデザインっぽいアイコンと『小マクロ集』|アイコン]] を作ったり、マクロバーにアイコンを詰め込むために [[#スクショ|試行錯誤]] したりも…。
マクロをツールバー/マクロバーから使用するために [[マテリアルデザインっぽいアイコンと『小マクロ集』|アイコン]] を作ったり、マクロバーにアイコンを詰め込むために [[#スクショ|試行錯誤]] したりも…。
265行目: 267行目:
: 「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にしてコードを組むか、組み込み関数「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない…。
: 「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にしてコードを組むか、組み込み関数「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない…。
<br>
<br>
* [[マクロリファレンス:PopupMenu インターフェイス#AddPopup メソッド|PopupMenu.AddPopup() メソッド]] では [[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|Add() メソッド]] の第三引数(meMenuChecked, meMenuGrayed, meMenuSeparator)は使用できない。
* [[マクロリファレンス:PopupMenu インターフェイス#AddPopup メソッド|PopupMenu.AddPopup() メソッド]] では [[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|Add() メソッド]] の第三引数(''meMenuChecked, meMenuGrayed, meMenuSeparator'')は使用できない。
: サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように PopupMenu.AddPopup() 周りを if() 文で囲うしかない。
: サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように ''PopupMenu.AddPopup()'' 周りを if() 文で囲うしかない。
: 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。
: 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。


278行目: 280行目:
* まず、[[利用者:Masme|masme]] 氏の「[[行並べ替え]]」や「[[連番を挿入]]」マクロのように、[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Statements/do...while do ... while() 文] によるループを利用して、動作設定の既定値を何度も書き換えながらポップアップメニューを再描画する方法がある。
* まず、[[利用者:Masme|masme]] 氏の「[[行並べ替え]]」や「[[連番を挿入]]」マクロのように、[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Statements/do...while do ... while() 文] によるループを利用して、動作設定の既定値を何度も書き換えながらポップアップメニューを再描画する方法がある。
: 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。
: 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読みなおす・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読み直す・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。
: これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の Serialize() / Deserialize() を利用して、ポップアップメニュー内の「設定変更」サブメニューから変更した設定値を外部ファイル(JSON ファイル)に保持できるようにしている。
: これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の Serialize() / Deserialize() を利用して、ポップアップメニュー内の「設定変更」サブメニューから変更した設定値を外部ファイル(JSON ファイル)に保持できるようにしている。
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。
287行目: 289行目:
選択範囲の 開始(キャレットなし)/終了(キャレットあり) の位置は [[マクロリファレンス:Selection インターフェイス#GetAnchorPos メソッド|Selection.GetAnchorPos()]] と [[マクロリファレンス:Selection インターフェイス#GetActivePos メソッド|Selection.GetActivePos()]] とで取得できるが、先頭/末尾 の位置はそれらをもとにして前後関係を割りだす必要がある。
選択範囲の 開始(キャレットなし)/終了(キャレットあり) の位置は [[マクロリファレンス:Selection インターフェイス#GetAnchorPos メソッド|Selection.GetAnchorPos()]] と [[マクロリファレンス:Selection インターフェイス#GetActivePos メソッド|Selection.GetActivePos()]] とで取得できるが、先頭/末尾 の位置はそれらをもとにして前後関係を割りだす必要がある。
<br>
<br>
※ GetTopPos() や GetBottomPos() というメソッドはない。 <br>
<span style="color:#c00;">※ '''GetTopPos()''' や '''GetBottomPos()''' というメソッドはない。 </span><br>
<source lang="javascript">
<source lang="javascript">
var ancPos, actPos, topPos, endPos;
var ancPos, actPos, topPos, endPos;
303行目: 305行目:




== [[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Collapse() メソッド]] とキャレット位置 ==
== Collapse() メソッド とキャレット位置 ==
Selection.Collapse() メソッド で引数 ''meCollapseEnd'' を指定した場合は
[[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Selection.Collapse() メソッド]] で引数 ''meCollapseEnd'' を指定した場合は
  Selection.SetActivePos( Selection.GetActivePos() )  
  Selection.SetActivePos( Selection.GetActivePos() )  
''meCollapseStart'' を指定した場合は
''meCollapseStart'' を指定した場合は
311行目: 313行目:
<br><br>
<br><br>
※ 引数を省略した場合は ''meCollapseStart'' として動作する。<br>
※ 引数を省略した場合は ''meCollapseStart'' として動作する。<br>
※ ''meCollapseStart / meCollapseEnd'' はそれぞれ「選択開始位置」と「選択終了位置 (キャレット位置)」を指し、「選択範囲の 先頭 / 末尾」ではない。<br>
※ ''meCollapseStart / meCollapseEnd'' はそれぞれ「選択開始位置」と「選択終了位置 (キャレット位置)」を指し、「選択範囲の 先頭/末尾」ではない。<br>
※ [[マクロリファレンス:Selection インターフェイス#SelectLine メソッド|Selection.SelectLine()]] や [[マクロリファレンス:Selection インターフェイス#SelectWord メソッド|Selection.SelectWord()]] などでの範囲選択では「キャレット位置=選択範囲の末尾」となり、[[マクロリファレンス:Selection インターフェイス#Find メソッド|Selection.Find()]] や [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|Selection.FindRepeat()]] での範囲選択では「キャレット位置=選択範囲の先頭」なので、つづけて Collapse() メソッドを使用するする場合には注意が必要。
※ [[マクロリファレンス:Selection インターフェイス#SelectLine メソッド|Selection.SelectLine()]] や [[マクロリファレンス:Selection インターフェイス#SelectWord メソッド|Selection.SelectWord()]] などでの範囲選択では「キャレット位置=選択範囲の末尾」となり、[[マクロリファレンス:Selection インターフェイス#Find メソッド|Selection.Find()]] や [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|Selection.FindRepeat()]] での範囲選択では「キャレット位置=選択範囲の先頭」なので、つづけて Collapse() メソッドを使用するする場合には注意が必要。
<br><br>
<br><br>


== Find() メソッド と FindRepeat() メソッド の 定数 ==
== Find() メソッド と FindRepeat() メソッド の 定数 ==
※[https://github.com/haijinboys/mery-plugin-sdk/blob/master/SDK/C/Basic/plugin.h 定数] の数値は
※ [https://github.com/haijinboys/mery-plugin-sdk/blob/master/SDK/C/Basic/plugin.h 定数] の数値は
  Alert( meFindNext );
  Alert( meFindNext );
のような1行マクロでも調べることができます。
のような1行マクロでも調べることができる。
<br><br>
<br><br>
; [[マクロリファレンス:Selection インターフェイス#Find メソッド|Find() メソッド]]
; [[マクロリファレンス:Selection インターフェイス#Find メソッド|Find() メソッド]]
364行目: 366行目:
document.selection.Find( "", 0 );
document.selection.Find( "", 0 );
</source>
</source>


== スクロール位置の調整 ==
== スクロール位置の調整 ==
キャレットをジャンプさせた後のスクロール位置とキャレット位置は、移動した行数がエディタの表示領域の高さに収まるかどうか(スクロールマージンの考慮が必要)とジャンプ方向によるので安定的ではない。<br>
キャレットをジャンプさせた後のスクロール位置とキャレット位置は、移動先の行(表示座標での行番号)がエディタの表示領域の高さに収まるかどうかとジャンプ方向によるので安定的ではない(スクロールマージンの考慮も必要)。
<br>
以下のコードは、ジャンプ後にエディタの表示領域がスクロールした場合に、キャレットが表示領域の [[マクロリファレンス:Window インターフェイス#ScrollY プロパティ|先頭位置(window.ScrollY)]] になるように調整するもの。
以下のコードは、ジャンプ後にエディタの表示領域がスクロールした場合に、キャレットが表示領域の [[マクロリファレンス:Window インターフェイス#ScrollY プロパティ|先頭位置(window.ScrollY)]] になるように調整するもの。
<source lang="javascript">
<source lang="javascript">
388行目: 392行目:
</source>
</source>


※ スクロールマージンは [https://www.haijin-boys.com/software/mery/mery-2-7-0#2 ベータ版 2.7.0] より「オプション」ダイアログの「スクロール」のページ内で変更できるようになっている。[https://www.haijin-boys.com/weblog/assets/uploads/2019/04/mery-2-7-0-4.png?20190417]
<br><br>


== カレントディレクトリ ==
== カレントディレクトリ ==
539行目: 545行目:
※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。
※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。
<br><br>
<br><br>
== Window オブジェクト ==
通常はソースコード内で [[マクロリファレンス:Window インターフェイス|Window オブジェクト]] を明示的に記述する必要はないが、[[#動作要件としてのバージョンチェック|バージョンチェック]] の節の「例4」のように実際に記述する場合には '''''Window''''' ではなく '''''window''''' でないと宣言されていない変数・オブジェクトあつかいのエラーになる。
※ '''''Document''''' や '''''Selection'''''、'''''Alert''''' など他の主要なプロパティは「大文字/小文字/頭文字のみ大文字」の区別なしに同一のプロパティとしてあつかわれる。
<br><br>
== FileSystemObject と WScript.Shell でファイルパスを引数にするとき ==
引数として使用するファイルパス文字列に '''半角空白''' がふくまれている場合、
* [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc409800(v=msdn.10) FileSystemObject] ではパスをダブルクオートなどの <b style="color:#0000c0;">引用符で囲う必要がない</b>
* [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364436%28v%3dmsdn.10%29 WScript.Shell] などの WSH コードではパスをダブルクオートなどの <b style="color:#c00;">引用符で囲う必要がある</b>
<br>
よって、[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364421%28v%3dmsdn.10%29 WshShell.Run() コマンド] などで不特定のパス(または任意のパス)を指定するときは ''WshShell.Run( "\"" + path + "\"" )'' または ''WshShell.Run( '"' + path + '"' )'' のように記述しておき、パスに半角空白がふくまれていてもエラーにならないように備えておくとよい。
<source lang="javascript">
var path = "C:\\Hoge hoge\\Fuga fuga\\Piyo piyo.txt";
var fso = new ActiveXObject( "Scripting.FileSystemObject" );
var wshShell = new ActiveXObject( "WScript.Shell" );
if ( fso.FileExists( path ) ) {
  wshShell.Run( "\"" + path + "\"" );
}
</source>


== 警告・確認ダイアログとステータスバーの使い分け ==
== 警告・確認ダイアログとステータスバーの使い分け ==
549行目: 580行目:
ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] などのボタンの種類をカスタマイズでき、指定時間の経過後に自動で閉じさせることもできるが、引数の指定や戻り値の処理が煩雑なので、[はい], [いいえ], [キャンセル] の3ボタンが必要な場合でもなければお勧めはしない…。<br>
ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] などのボタンの種類をカスタマイズでき、指定時間の経過後に自動で閉じさせることもできるが、引数の指定や戻り値の処理が煩雑なので、[はい], [いいえ], [キャンセル] の3ボタンが必要な場合でもなければお勧めはしない…。<br>
※ アイコンなしにすれば、システムのサウンドなしでダイアログを表示できる。
※ アイコンなしにすれば、システムのサウンドなしでダイアログを表示できる。
<br><br>
== [[マクロリファレンス:Window インターフェイス|Window オブジェクト]] ==
通常はソースコード内で Window オブジェクトを明示的に記述する必要はないが、[[#動作要件としてのバージョンチェック|バージョンチェック]] の節の「例4」のように実際に記述する場合には '''''Window''''' ではなく '''''window''''' でないと宣言されていない変数・オブジェクトあつかいのエラーになる。
※ '''''Document''''' や '''''Selection'''''、'''''Alert''''' などの主要なプロパティは「大文字/小文字/頭文字のみ大文字」の区別なしに同一のプロパティとしてあつかわれる。
<br><br>
<br><br>


647行目: 672行目:
: ※ ZIP 版の Mery でマクロを作成・運用しているので、インストーラ版では正しく動作しないマクロがあるかもしれません。
: ※ ZIP 版の Mery でマクロを作成・運用しているので、インストーラ版では正しく動作しないマクロがあるかもしれません。
: ※ 開発環境が Windows XP なので、変数はすべて '''''var''''' で宣言し、JScript 5.8 の環境で実行できるようにコーディングしています。
: ※ 開発環境が Windows XP なので、変数はすべて '''''var''''' で宣言し、JScript 5.8 の環境で実行できるようにコーディングしています。
* Mery のオプション設定で「行の表示方法=論理座標(論理行)」の状態で運用する前提でマクロを作っています。公開しているマクロでは、「表示座標(表示行)」ベースで Mery を運用している場合でも利用できるように設定項目(変数)を設けるか「行の表示方法」を自動判定するコードを追加していますが、動作が不完全になったり処理がおそくなったりすることがあります。
* Mery のオプション設定で「行の表示方法=論理座標 (論理行)」の状態で運用する前提でマクロを作っています。公開しているマクロでは、「表示座標 (表示行)」ベースで Mery を運用している場合でも利用できるように設定項目(変数)を設けるか「行の表示方法」を自動判定するコードを追加していますが、動作が不完全になったり処理がおそくなったりすることがあります。
: ※「表示座標(表示行)」ベースでの動作テストはほとんどしていません。
: ※「表示座標 (表示行)」ベースでの動作テストはほとんどしていません。
* ソースコード内ではしばしば unicode 文字を使用していますので、マクロの JS ファイルは UTF-8 形式で保存する前提となっています。
* ソースコード内ではしばしば unicode 文字を使用していますので、マクロの JS ファイルは UTF-8 形式で保存する前提となっています。
* ソースコード内の変数名の検索などで「[[ポップアップメニューで検索先にジャンプ|検索ジャンプ]]」マクロを利用しやすいように(個人的にタグジャンプ系のマクロに馴染めないので)、マクロのコードには半角空白を多用しています。
* ソースコード内の変数名の検索などで「[[ポップアップメニューで検索先にジャンプ|検索ジャンプ]]」マクロを利用しやすいように(個人的にタグジャンプ系のマクロに馴染めないので)、マクロのコードには半角空白を多用しています。
スポンサーリンク