「Mery本体のバージョンチェック」を編集中


Mery のバージョンがマクロの要件以上かチェックする

== VersionCheck() 関数 ==

;組み込み関数 VersionCheck()
マクロを動作させるうえでの必要条件として Mery 本体のバージョンチェックをおこないます。<br>
要件以上のバージョンであれば true、要件を満たさなければ false を返します。

組み込み関数本体 を任意のマクロのソースコード内にペーストして使用します。<br>
使い方は [[#使い方|使用例]] を参考にしてください。


== ソースコード ==

<source lang="javascript">
// #title = "Mery のバージョンチェック"
/**
 * 組み込み関数 VersionCheck( versionStr )
 * Mery 本体が引数で指定したバージョン以上かチェックする（ e.g. "2.7.0" ）
 * 戻り値は、真偽値 true/false
 */
function VersionCheck( versionStr ) {
  // 文字列中の半角１ケタの数字を０埋めする
  var Pad2 = function( string ) {
    return string.replace( /[0-9]+/g , function( $0 ) {
      return $0.length < 2 ? "0" + $0 : $0;
    } );
  }
  // バージョンNo. "X.Y.ZZ" を数値 X0YZZ にする（e.g. "2.7.0" => 20700）
  var editorVer = Number( Pad2( editor.Version ).replace( /\./g, "" ).slice( 0, 6 ) );
  var requirement = Number( Pad2( versionStr ).replace( /\./g, "" ).slice( 0, 6 ) );
  return ( editorVer >= requirement );
}
</source>


== 使い方 ==

 /**
  * 【使い方】
  *
  * 要件以上のバージョンであればメインのコードを実行し
  * 要件未満のバージョンであれば別のコードを実行する
  *
  * ※引数に指定するバージョンNo.は "ダブルクオート" で囲うこと
  */


'''例１'''  Begin/EndUndoGroup() メソッドを使えるのは ver 2.7.0 以降

<source lang="javascript">
// 文書の先頭/末尾に <html> </html> 、改行部分に <br/> を挿入する
if ( VersionCheck( "2.7.0" ) ) {
  // ブックマーク設定を維持して置換
  BeginUndoGroup();
  document.selection.Replace( "\n", "<br/>\n", meFindReplaceRegExp + meReplaceAll );
  document.selection.StartOfDocument();
  document.selection.Text = "<html>\n";
  document.selection.EndOfDocument();
  document.selection.Text = "\n</html>";
  EndUndoGroup();
}
else {
  var confirmStr = "Mery 2.7.0 以上でないとブックマーク設定がふっ飛びます。"
                 + "\n\n実行しますか？";
  if ( Confirm( confirmStr ) ) {
    // ブックマーク設定を無視して一括置換
    document.Text = "<html>\n" + document.Text.replace( /$/gm, "<br/>" ) + "\n</html>";
  }
}


// Begin/EndUndoGroup() のみを囲うだけでもよいが、アンドゥするとき面倒なことに…
if ( VersionCheck( "2.7.0" ) ) {
  BeginUndoGroup();
}

</source>


'''例２'''  ChangeCase() メソッドで定数 meCaseCapitalize を使えるのは ver 2.6.10 以降

<source lang="javascript">
if ( document.Selection.IsEmpty ) {
  document.selection.SelectLine();
}

if ( VersionCheck( "2.6.10" ) ) {
  // 単語の最初の文字を大文字に変換
  document.selection.ChangeCase( meCaseCapitalize );
}
else {
  // 小文字に変換
  document.selection.ChangeCase( meCaseLowerCase );
  Status = "小文字でごめん。";
}
</source>