・第 100 行目へ移動：
　　::Epsaly.MoveTo( 100'LineNo );

・第 200 行、40 桁目へ移動：
　　::Epsaly.MoveTo( 200'LineNo, 40'Column );

・現位置から 3 論理行だけ先へ移動：
　　::Epsaly.MoveTo( 3'LLn );

・現位置から 1 字前へ移動：
　　::Epsaly.MoveTo( -1'DKn );

・次の表示行の先頭から 5 単語目へ移動：
　　::Epsaly.MoveTo( 1'VLn, 4'LWn );

・論理行インデックスが 123 の行の行頭へ移動：
　　::Epsaly.MoveTo( 123'LLi, 'LineTop );

・現カーソル行を画面上端から 3 行目にシフト：
　　::Epsaly.MoveTo( 3'SLn );

本関数の返値は、正常終了の時に、挿入した文字列のコード数になり、不正終了時に、 null になります。

　　::Epsaly.Insert( "Hello, world" );
この実行では、現カーソル位置に "Hello, world" という文字列が挿入され、 カーソルはこの文字列の末尾に行きます。

　　::Epsaly.Insert( "Hello, world\n", 0 );
この実行では、"Hello, world" に LF 単独の改行コードが付いた文字列が挿入され、 カーソルはこの文字列の先頭に行きます。

　　::Epsaly.Insert( "Hello, @world\r\n", "@" );
この実行では、"Hello, world" に CR/LF の改行コードが付いた文字列が挿入され、 カーソルはこの文字列内の world の先頭に行きます。

    if( A == B )
    ┃
    X = Y + Z;

    if( A == B )
    {
        A = 1;
        B = 2;
    }┃
    X = Y + Z;

    if( A == B )  ┃
    X = Y + Z;

    if( A == B )  {
        A = 1;
        B = 2;
    }┃
    X = Y + Z;

　　ABCDEFGH
　　abcdefgh
　　12345678

　　ABCD--X--EFGH
　　abcd--Y--efgh
　　1234--Z--5678

　　あいうえお
　　かきくけこ
　　さしすせそ

　　あい-ABC-
　　-XYZ- けこ
　　さしすせそ

　　111222333
　　AAABBBCCC
　　ｱｱｱｲｲｲｳｳｳ

　　111--X--333
　　AAA--Y--CCC
　　ｱｱｱ--Z--ｳｳｳ

引数 s は、挿入する文字列を指定します。 本関数では、基本的に、挿入された文字列が、選択状態になります。 なお、引数 s は、空文字列でも構いませんが、非文字列の場合は不正になります。

本関数の返値は、正常終了の時に、挿入した文字列のコード数になります。 不正終了時は、null になります。

　　111222333
　　AAABBBCCC
　　ｱｱｱｲｲｲｳｳｳ

　　111--X--333
　　AAA--Y--CCC
　　ｱｱｱ--Z--ｳｳｳ

　　AAA┃BBB

　　AAA--X--┃BBB

編集テキストに対して、以下の ・・・・・ のところで行なった変更は、 １回の「元に戻す( Undo )」で、まとめて復元されます。

  ::Epsaly.UndoBlockBegin();
  　　・・・・・
  ::Epsaly.UndoBlockEnd();

  scope ::Epsaly
  {
      .UndoBlockBegin();
      .MoveTo( 'LineTop );
      for( i = 1 ; i <= 10 ; i++ )
      {
          .Insert( "(%i)"'fmt(i), 0 );
          .MoveTo( +1'LLn );
      }
      .UndoBlockEnd();
  }

・テキスト先頭から現カーソル位置までの矩形範囲を選択：
　　::Epsaly.SelectRect( 'TextTop );

   fs = ::Epsaly.FreeCursor(1);  // 現フリーカーソル状態取得
   ::Epsaly.FreeCursor(1);       // フリーカーソルＯＮ
   ::Epsaly.SelectRect();    // 現位置が矩形範囲選択の始点
     ・・・・・          // 矩形範囲選択の終点へカーソル移動
     ・・・・・          // 矩形選択範囲に対する何かの操作
   ::Epsaly.FreeCursor(fs);  // フリーカーソル状態の復元

・選択範囲をコンソールウィンドウにプリント：
    print ::Epsaly.GetSelText();
・選択範囲をクリップボードにコピー：
    ::Clipboard.SetText( ::Epsaly.GetSelText() );
・選択範囲の「英小文字→英大文字」変換：
    ::Epsaly.SetSelText( ::Epsaly.GetSelText()'upper );
・選択範囲内の空白を除去：
    ::Epsaly.SetSelText( ::Epsaly.GetSelText()
        'subst( "[ \t　]", "" ) );
・選択範囲の各行頭に引用符を付加：
    ::Epsaly.SetSelText( ::Epsaly.GetSelText()
        'subst( "@(.*\n|.+$)", "> @1" ) );

この返値は、２項値になります。２項値は、多重代入で取得します。例えば、次のようにします。

　( MinVLi, MaxVLi ) = ::Epsaly.GetSelRange( 0 );

これで、選択範囲の最小と最大の表示行インデックスが、それぞれ、 MinVLi と MaxVLi という変数に代入されます。
他の S の値の場合の例も示すと、次のようになります。

　( MinXs, LimXs )　 = ::Epsaly.GetSelRange( 1 );
　( MinCi, LimCi )　 = ::Epsaly.GetSelRange( 2 );
　( OrgVLi, CurVLi ) = ::Epsaly.GetSelRange( 3 );
　( OrgXs, CurXs )　 = ::Epsaly.GetSelRange( 4 );
　( OrgCi, CurCi )　 = ::Epsaly.GetSelRange( 5 );
　( MinFLi, MaxFLi ) = ::Epsaly.GetSelRange( 6 );
　( OrgFLi, CurFLi ) = ::Epsaly.GetSelRange( 7 );
　( FLi, FLn )　　　 = ::Epsaly.GetSelRange( 8 );
　( VLi, VLn )　　　 = ::Epsaly.GetSelRange( 9 );

上表で、「最小」「最大」「上限」の関係は、次の通りです。
　　最小値 ≦ 範囲内の値 ≦ 最大値 ＜ 上限値
通常、上限値 ＝ 最大値 ＋１ になります。

「始点」は、その範囲選択の開始点でアンカー的ですが、「終点」は、 現カーソル位置に対応した流動的な端点です。そのため、これらの値の大小関係は、 範囲選択の状態に依存します。
Ｘ座標に関しては、'Xc 関数で説明しています。

引数 Li は、S=1 または S=2 の時に、選択範囲内の特定の行だけの情報を取得する場合に、 その行の表示行インデックスを指定します。 これ以外の場合、Li の指定は不用です。

次のスクリプトは、現テキストの文字コード数をプリントします。
　print "現テキスト文字コード数： " : ::Epsaly.GetFullCn();

次のスクリプトを実行すると、LineCn という名前の箱（変数）に、 全表示行の各文字コード数を要素とする純粋配列が設定されます。
　::Epsaly.GetFullCn( LineCn'new! );
ちなみに、LineCn'size / 2 の値は、全表示行数になります。

  txbuf = ::Buffer();
  txbuf.Write( ::Epsaly.GetFullText() );
  txbuf.Seek(0);
  count'cbox!;
  for( v = txbuf.Find( $"\w+" ) ;
       v >= 0 ;
       v = txbuf.FindNext() )
  {
      word = txbuf.FoundText();
      if( count[ word ]'exist? )
          count[ word ]++;
      else
          count[ word ] = 1;
  }
  count'qsort;
  for( p := count'first ; p'ref? ; p := count'next )
      print p : "\t" : p'name;

・現カーソル行の文字コード数を取得：
　　::Epsaly.GetLineCn()

・次の表示行の文字コード数を取得：
　　::Epsaly.GetLineCn( +1'VLn )

・２行前の論理行の文字コード数を取得：
　　::Epsaly.GetLineCn( -2'LLn )

    MaxSize = 0;
    N = ::Epsaly.MaxLineNo(1);
    for( i = 0 ; i < N ; i++ )
    {
        CurSize = ::Epsaly.GetLineCn( i'LLi );
        if( MaxSize < CurSize )
            MaxSize = CurSize;
    }
    print MaxSize;

・現カーソル行の文字列を取得：
　　::Epsaly.GetLineText()

・次の論理行の文字列を取得：
　　::Epsaly.GetLineText( +1'LLn )

・３行前の表示行の文字列を取得：
　　::Epsaly.GetLineText( -3'VLn )

    'match( "ABC" );
    N = ::Epsaly.MaxLineNo(1);
    for( i = 0 ; i < N ; i++ )
    {
        T = ::Epsaly.GetLineText( i'LLi );
        if( T'match >= 0 )
            print T :- ;
    }

　 0 　変更の有無
　 1 　折り返し行か否か（ 論理行の場合は、折り返し行の有無 ）
　 2 　マークの有無
　 3 　折り畳みの中にある行か否か
　 4 　折り畳みで隠された行か否か
　 5 　空行（改行だけの行）か否か
　 6 　空白行（空または空白だけの行）か否か
　 7 　インデント（字下げ）の桁数
　 8 　論理行内の表示行数（＝折り返し回数＋１）
　 9 　論理行内の相対表示行インデックス（ 論理行の場合、常に 0 ）
　10 　折り畳み段数（ >0: 折り畳み深さ、<0: 展開レベル、= 0: 解除 ）
　11 　対象行を含む折り畳み部の表示行数
　12 　　　 〃 　　折り畳み部内での対象行の相対表示行インデックス
　13 　　　 〃 　　折り畳み部の総表示行数
　14 　　　 〃 　　折り畳み部の総論理行数
　15 　　　 〃 　　折り畳み部の総文字コード数

・100 行目が変更されているか否か：
　　::Epsaly.GetLineCond( 0, 100'LineNo )

・現カーソル行が折り畳み行か否か：
　　::Epsaly.GetLineCond( 3 )

・次の外見行が空行か否か：
　　::Epsaly.GetLineCond( 5, +1'FLn )

・２行前の論理行の折り返し行数：
　　::Epsaly.GetLineCond( 8, -2'LLn )

    M = 0;
    N = ::Epsaly.MaxLineNo( 0 );
    for( i = 0 ; i < N ; i++ )
    {
        if( ::Epsaly.GetLineCond( 2, i'VLi ) )
            M++;
    }
    print M;

・現カーソル位置から行末までの文字コード数を取得：
　　::Epsaly.GetPartCn( 'LineEnd )

・現カーソル位置からテキスト先頭までの文字コード数を取得：
　　::Epsaly.GetPartCn( 'TextTop )

・現カーソル位置から前の論理行の 8 桁目までの文字コード数を取得：
　　::Epsaly.GetPartCn( -1'LLn, 8'Column )

・現カーソル位置から行頭までの文字列を取得：
　　::Epsaly.GetPartText( 'LineTop )

・現カーソル位置からテキスト末尾までの文字列を取得：
　　::Epsaly.GetPartText( 'TextEnd )

・現カーソル位置から次の論理行の 8 桁未満までの文字列を取得：
　　::Epsaly.GetPartText( +1'LLn, 8'Column )

本関数の引数は、「編集テキスト内の位置を 規定するリレー型関数」を使って指定します。
本関数は、この引数で指定された位置にある所定区間の文字列を返します。
所定区間というのは、その位置の文字が、
　　・英単語構成文字( A-Z a-z 0-9 _ )
　　・ひらかな
　　・カタカナ
　　・漢字
　　・全角英数字
　　・全角空白
　　・半角空白
　　・半角ｶﾀｶﾅ
のうちのどれかの場合、その位置の前後で、それと同種の文字が連続する範囲のことです。
また、その位置の文字が、
　　・半角括弧　( )　{ }　[ ]　< >　｢ ｣
　　・全角括弧 （ ）｛ ｝［ ］〈 〉「 」
　　　　　　　 〔 〕《 》『 』【 】＜＞
のうちのどれかの場合、それに対応する括弧で囲まれる範囲になります。
もし、その位置の文字が、上記以外の場合、空文字列を返します。

・現カーソル位置にある所定区間の文字列を取得：
　　::Epsaly.GetTerm()

・現在の行頭から 8 桁目にある所定区間の文字列を取得：
　　::Epsaly.GetTerm( 'LineTop, 8'Column )

・現カーソル位置の１文字（の文字列）を取得：
　　::Epsaly.GetChar()

・現カーソル行の行頭の１文字（の文字列）を取得：
　　::Epsaly.GetChar( 'LineTop )

・表示行インデックス i を論理行インデックス j に変換：
　　j = ::Epsaly.EvalTxpos( i'VLi, 0'LLn );

・論理行インデックス i を外見行インデックス j に変換：
　　j = ::Epsaly.EvalTxpos( i'LLi, 0'FLn );

・現カーソル行の次の表示行の行頭から 2 単語目の桁位置：
　　::Epsaly.EvalTxpos( +1'VLn, 'LineTop, +2'DWn, 0'Xd )

・100 行目の行頭から 12 字目の文字コードインデックス：
　　::Epsaly.EvalTxpos( 100'LineNo, 'LineTop, 12'DCn )

・現カーソル行の論理行インデックス：
　　CurLLi = 'LLi;

・現カーソル行の外見行インデックス：
　　CurFLi = 'FLi;

折り返し桁数が、n の値に設定されます。設定可能な範囲は、20 〜 1024 桁です。

現環境設定の値に合わせて折り返すように設定されます。

n の値に関係なく、現ウィンドウ幅に合わせて折り返すように設定されます。

折り返し桁数は設定せずに、現在の折り返し桁数を返します。

全タブ間隔を N 桁に設定します。設定可能な範囲は、2 〜 80 桁です。 もし、N の値がこの範囲外なら、この範囲でカットされます。

タブ間隔を、現環境設定の桁数に設定します（戻します）。

各タブ間隔の桁数を順に、その各要素の数値に設定します。 なお、この純粋配列は、１次元の LONG 形式が必須です。

各タブ間隔の桁数を順に、その箱の中の各数値に設定します。

タブ間隔は設定せずに、現在のタブ間隔の桁数を返します。

その桁数の整数値を返します。

その各桁数の整数値を要素とする純粋配列を返します。

全タブ間隔を 8 桁に設定：
　::Epsaly.TabColumn( 8 );

タブ間隔を、現環境設定に戻す：
　::Epsaly.TabColumn( 0 );

各タブ間隔を 10,8,12,4 桁に設定：
　N = { 10,8,12,4 };
　::Epsaly.TabColumn( N );

次のスクリプトは、選択範囲の各行（または現在行）の 80 桁目に縦の罫線文字「│」を挿入します。 80 桁未満で改行されている行にも対応できるように、 各行の 80 桁目へのカーソル移動は、フリーカーソル ON 状態で行なっています。 なお、本スクリプトの実行時には、折り返し桁が 81 桁以上になっている必要があります。

  'AddScope( ::Epsaly );
  if( GetSelType() > 0 )  // 範囲選択あり？
  {
      ( MinLi, MaxLi ) = GetSelRange( 0 );
      SelectOff();
  }
  else    // 範囲選択なし？
      MinLi = MaxLi = 'VLi;    // 現在行

  fc = FreeCursor();  // 現フリーカーソル状態を保管
  FreeCursor(1);      // フリーカーソル ON 状態にする
  UndoBlockBegin();
  for( Li = MinLi ; Li <= MaxLi ; Li++ )
  {
      MoveTo( Li'VLi, 80'Column );
      Insert( "│" );
  }
  UndoBlockEnd();
  FreeCursor( fc );   // 元のフリーカーソル状態に戻す

引数 cmd は、ＩＭＥの操作を以下の数値で指定します。
　 0 　IME を OFF にする
　 1 　IME を ON にする
　 2 　IME の ON/OFF 状態を取得
　 3 　再変換を起動
　 4 　単語登録ダイアログボックスを表示
引数 prm は、次のようになります。
　cmd = 0,1,2 の時、不要
　cmd = 3 の時、再変換文字列（補説参照）
　cmd = 4 の時、登録単語

返値は、次のようになります。
　cmd = 0,1,3,4 の時、成否を示す真偽値
　cmd = 2 の時、ＩＭＥの現在の ON/OFF 状態
　cmd = それ以外の時、null

再変換の対象文字列は、次のようになります：
　引数 prm に指定されていれば、その文字列、さもなくて、
　選択範囲が有る場合、その範囲内の現カーソル行の文字列
　選択範囲が無い場合、現カーソル位置の前後からＩＭＥが選定

・ＩＭＥを ON に設定：
　　::Epsaly.IME( 1 );

・ＩＭＥの再変換を起動：
　　::Epsaly.IME( 3 );

　 0 　通常マークを解除
　 1 　通常マークを設定
　 2 　通常マークの設定状態を反転
　 3 　通常マークを全て解除
　 4 　一時マークを解除
　 5 　一時マークを設定
　 6 　一時マークの設定状態を反転
　 7 　一時マークを全て解除
　-1 　現在の行マーク状態を取得

引数 t が省略時は、-1 の指定として解釈します。
引数の ... には、「編集テキスト内の位置を 規定するリレー型関数」を使って、行マーク操作の対象行を指定します。 なお、引数 t が 3 または 7（全マーク解除）の時、引数 ... の指定は不要です。

返値は、以下の数値で、本関数実行後の対象行のマーク設定状態を示します。

　 0 　両マークとも無し
　 1 　通常マークのみ有り
　 2 　一時マークのみ有り
　 3 　両マークとも有
　-1 　引数不正 or エラー

・現カーソル行に通常マークを設定：
　　::Epsaly.MarkLine( 1 )

・論理行インデックスが 120 の行に一時マークを設定：
　　::Epsaly.MarkLine( 5, 120'LLi );

・全ての一時マークを解除：
　　::Epsaly.MarkLine( 7 )

・230 行目の行マークの設定状態を取得：
　　::Epsaly.MarkLine( 230'LineNo );

引数 i が、0 〜 31 の時、それぞれ、0 〜 31 番のアンカーの位置を、 引数の ... で規定される位置に設定します。 設定されたアンカーは、'AP という関数で参照できます。
引数 i が、-1 〜 -32 の時、それぞれ、0 〜 31 番のアンカーを解除します。
引数 i が省略の時、0 として解釈します。

引数 ... では、「編集テキスト内の位置を 規定するリレー型関数」を使って、アンカーの設定位置を指定します。 アンカーの設定で、引数 ... を省略すると、現カーソル位置が設定されます。 なお、アンカーの解除の時には、引数 ... の指定は不要です。

返値は、当該アンカーの前の設定位置の文字コードインデックスになります。

・現カーソル位置に１番のアンカーを設定：
　　::Epsaly.SetAnchor( 1 )

・論理行インデックスが 120 の行頭に５番のアンカーを設定：
　　::Epsaly.SetAnchor( 5, 120'LLi, 'LineTop );

・０番のアンカーを解除：
　　::Epsaly.SetAnchor( -1 )

引数 string と mode は、SetFindCond 関数と同じです。 string の指定がない時、現在の検索文字列が使用されます。 mode の指定がない時、現在の検索モードが使用されます。 同じ検索条件で何回も検索する場合は、最初に SetFindCond 関数で検索条件を設定しておいて、各回の検索では、 本関数を引数なしでコールする方が、毎回本関数で同じ検索条件を指定してコールする よりも速くなります。

引数 type は、置換のための検索を行なわせる時に、1 を指定します。 この引数は省略または 0 の指定で、通常の検索になり、置換のための検索は行ないません。 ちなみに、置換条件の設定は、SetReplCond 関数で行ないます。

引数 hist は、string が指定された場合、今回の検索条件（検索文字列と検索モード）を、 履歴に保存しない時に、真値(1)を指定し、履歴に保存する時に、偽値(0)を指定するか省略します。

本関数は、検索結果を示す整数値を返します。
検索に成功した時、返値は、0 以上の値になります。 正規表現で「一致パターン識別値」が規定されていて、 その部分に一致した場合、その識別値が返値になります。これは通常、正の値です。 もし、その部分に一致しないか、または、正規表現でなければ、返値は 0 になります。
検索に失敗した時、返値は、以下に示す負値になります。
　　= -1:　一致なし
　　= -2:　検索中断（ユーザー指令による）
　　= -3:　正規表現が複雑過ぎ
　　= -4:　致命的エラー発生
本エディタでは、検索は補助スレッドが行ないます。そのため、 このスレッドが他の作業中の時に、本関数を実行しても、検索は失敗します。 そのような場合、本関数は、適当な負の値（ 現状、-99 ）を返します。

・現検索条件で順行検索を実行：
　　::Epsaly.FindFwd();

・"ABC" を順行検索して選択：
　　::Epsaly.FindFwd( "ABC", "G" );

・"ABC" を含む行を順行検索：
　　::Epsaly.FindFwd( $"^.*ABC.*\n", "R" );

・一連の空白行を順行検索して選択：
　　::Epsaly.FindFwd( $"(^[ \t　]*\n)+", "RGE" );

・現検索条件で逆行検索を実行：
　　::Epsaly.FindBwd();

・"XYZ" を逆行検索して選択：
　　::Epsaly.FindBwd( "XYZ", "G" );

・空白を含まない行を逆行検索：
　　::Epsaly.FindBwd( $"^[^ \t　\n]*\n", "R" );

本関数の検索で一致する文字列部分は、その先頭から末尾までのどこかに、現カーソル位置が 必ず含まれます。

現在行において現在位置の前後で漢字とひらかなから成る文字列部を選択：
　　::Epsaly.FindAround( $"[\K\H]+", "RG" );

現状、折り畳みは、論理行単位で、 ２行以上の外見行に対してだけで行なえます。 そのため、引数で指定された行範囲が、この制約に合わない場合、次のように補正されます。 まず、折り畳みの開始行が、既に折り畳まれている中にある行に指定された場合、 実際の開始行は、その行が含まれる折り畳み行（外見行）に補正されます。 次に、折り畳み範囲の行数は、外見行単位で指定しますが、 その行範囲が、論理行単位になっていない場合、実際の行範囲は、 その指定範囲を含む最小の論理行単位の範囲に補正されます。 なお、補正された最終の行範囲に、外見行が２行以上なければ、折り畳みは行なわれません。

・100 行目以降 20 行分の外見行範囲を折り畳む：
　　::Epsaly.MakeFold( 100'LineNo, 20 );

・現カーソル行以降 10 行分の外見行範囲を折り畳む：
　　::Epsaly.MakeFold( 10 );

・現カーソル行以前 10 行分の外見行範囲を折り畳む：
　　::Epsaly.MakeFold( -10 );

・200 行目以降 40 行分の外見行範囲に折り目を付ける：
　　::Epsaly.PresetFold( 200'LineNo, 40 );

・現カーソル行以降 30 行分の外見行範囲に折り目を付ける：
　　::Epsaly.PresetFold( 30 );

引数 ... で指定された開始行が、既に折り畳まれている中にある行の場合、 その行が含まれる折り畳み行（外見行）が、実際の開始行になります。

引数 dv = 1 の時、指定行範囲内にある各折り畳み行だけが展開されます（その中にある 折り畳み行は展開されません）。 dv = 2 の時、各折り畳み行とその直下の各折り畳み行だけが展開されます。 以降、dv >= 3 の時も同様です。 dv 省略時は、全段、つまり、指定行範囲内にある全ての折り畳み行が、展開されます。

・100 行目以降 20 行分の外見行範囲内にある折り畳みを１段展開：
　　::Epsaly.OpenFold( 100'LineNo, 20, 1 );

・現カーソル行以降 50 行分の外見行範囲内にある折り畳みを全段展開：
　　::Epsaly.OpenFold( 50 );

ln の絶対値 ≧ 2 の時、本関数は、対象範囲内に完全に含まれている各折り畳み展開部の 最内段（最も深く折り畳まれていた展開部）から順に外側の段に向かって、 指定段数だけ折り畳み直します。 なお、対象範囲内に部分的にしか含まれていない展開部は対象外になります。

ln の絶対値 ≦ 1 の時、本関数は、対象範囲（開始行の１行）を含む折り畳み展開部の 最内段（上記参照）から順に外側の段に向かって、指定段数だけ折り畳み直します。

返値は、実際に折り畳んだ外見行数になります。なお、異常終了時は、-1 が返ります。

引数 ... で指定された開始行が、既に折り畳まれている中にある行の場合、 その行が含まれる折り畳み行（外見行）が、実際の開始行になります。

引数 dv = 1 の時、対象の折り畳み展開部の最内段だけが折り畳み直されます。 dv = 2 の時、最内段とその次に外側の展開部が折り畳み直されます。 以降、dv >= 3 の時も同様です。 dv 省略時は、対象範囲内にある全ての深さの折り畳み展開部が、 折り畳み直されます。

・100 行目以降 20 行分の外見行範囲内にある折り畳み展開部を１段閉じる：
　　::Epsaly.CloseFold( 100'LineNo, 20, 1 );

・現カーソル行以降 30 行分の外見行範囲内にある折り畳み展開部を２段閉じる：
　　::Epsaly.OpenFold( 30, 2 );

・現カーソル行を含む折り畳み展開部を全段閉じる：
　　::Epsaly.CloseFold( 1 );

ln の絶対値 ≧ 2 の時、本関数は、指定行範囲内に含まれる各折り畳み行を指定段数だけ解除します。 また、その行範囲内に完全に含まれている各折り畳み展開部の 最内段（最も深く折り畳まれていた展開部）から順に外側の段に向かって、 指定段数だけその折り目を消します。 なお、対象行範囲内に部分的にしか含まれていない展開部の折り目は消しません。

ln の絶対値 ≦ 1 の時、本関数は、指定行範囲の開始行が折り畳み行なら、その行の折り畳みを 指定段数だけ解除します。さもなくて、その開始行が折り畳み展開部上なら、 その行を含む最内段（最も深く折り畳まれていた展開部）から順に外側の段に向かって、 指定段数だけその折り目を消します。

返値は、この解除によって増えた外見行数になります。なお、異常終了時は、-1 が返ります。

引数 ... で指定された開始行が、既に折り畳まれている中にある行の場合、 その行が含まれる折り畳み行（外見行）が、実際の開始行になります。

解除対象が折り畳み展開部の場合：

１段の解除では、対象の折り畳み展開部の最内段だけの折り目を消します。 ２段の解除では、最内段とその次に外側の展開部の折り目を消します。 以降、３段以上の時でも同様です。 全段の解除では、対象の折り畳み展開部の全ての折り目を消します。

解除対象が折り畳み行の場合：

１段の解除では、その折り畳み行だけの折り畳みを解除します。 ２段の解除では、その折り畳み行自身とその中の１段だけの折り畳みを解除します。 以降、３段以上の時でも同様です。 全段の解除では、その折り畳み行自身とそれに含まれる全ての折り畳みを解除します。

・100 行目以降 20 行分の外見行範囲内にある折り畳みを１段解除：
　　::Epsaly.ResetFold( 100'LineNo, 20, 1 );

・現カーソル行以降 30 行分の外見行範囲内にある折り畳みを２段解除：
　　::Epsaly.OpenFold( 30, 2 );

・現カーソル行の折り畳みを全段解除：
　　::Epsaly.ResetFold( 1 );

    id = ::Epsaly.PopupMenu( 0,
        "項目１",
        "項目２",
        "項目３",
         null,      // セパレータ
        "項目４" );
    print id;

    [ "項目３" ] =
        { "項目Ａ", "項目Ｂ", null, "項目Ｃ" };
    id = ::Epsaly.PopupMenu( 1,
        "項目１",
        "項目２",
        [ "項目３" ],   // サブメニュー項目
        "項目４" );
    print id;

    [ "" ] =	// 名前の無い複合箱に入れたメニュー項目
        { "項目３", "項目４", "項目５" };
    id = ::Epsaly.PopupMenu( 1,
        "項目１",
        "項目２",
        [ "" ],   // この中のメニュー項目は現階層に追加される
        "項目６" );
    print id;

　整数の場合：
　　 Bit31-24： イベント種別
　　　　= 0:　イベント無し
　　　　= 1:　キー押下
　　　　= 2:　キー離し
　　　　= 3:　マウスボタン押下
　　　　= 4:　マウスボタン離し
　　　　= 5:　マウスボタンダブルクリック
　　　　=11:　音声認識終了
　　 Bit23-16 :　未使用（全ビット０）
　　 Bit15-0　:　イベントコード
　　　 キーイベントの場合
　　　　　Bit15:　オートリピート状態
　　　　　Bit12:　Altキー状態
　　　　　Bit11:　Ctrlキー状態
　　　　　Bit10:　Shiftキー状態
　　　　　Bit7-0: 仮想キーコード
　　　 マウスイベントの場合
　　　　　Bit4:　中ボタン状態（現状対象外）
　　　　　Bit3:　Ctrlキー状態
　　　　　Bit2:　Shiftキー状態
　　　　　Bit1:　右ボタン状態
　　　　　Bit0:　左ボタン状態（現状対象外）
　　　上記規定以外のビットは全て０

　文字列の場合： キーボードから入力された文字列
　　 ・文字キーからはその１文字の文字列
　　 ・ＩＭＥ入力からは変換確定後の文字列

　　( ev, tv ) = ::Epsaly.GetEvent();

次のスクリプトは、イベントを取得して、適当な文字列に変換して、 現カーソル位置に挿入する、という操作を、 ESC キーが押されるまで、続けます。

  'AddScope( ::Epsaly );
  UndoBlockBegin();
  Insert( "Event Input Start\r\n"  );
  for( ;; )
  {
      ev = GetEvent();    // イベント入力まで待機
      switch( ev'type )
      {
        case "integer":  s = "0x" + ev'x(8);  break;
        case "string":   s = ev'quote;        break;
        default:         continue;
      }
      Insert( s + "\r\n" );
      if( ev == 0x01`00`00`1B )   // ESC キー？
          break;
  }
  Insert( "Event Input End\r\n"  );
  UndoBlockEnd();

マルチスレッドで、イベント取得を行なう 例は、スクリプト標準フォルダ 内 の AutoScroll.mc にあります。

　　Bit7-0:　仮想キーコード
　　Bit10: 　Shiftキー状態（ =0: OFF, =1: ON ）
　　Bit11: 　Ctrlキー状態 （ 同上 ）
　　Bit12: 　Altキー状態　（ 同上 ）

このキーコード関連のマクロ定義は、本エディタのインストール フォルダ 内の Include\GkLib\GkKey.mh に あります。

本関数の返値は、実行されたコマンドの識別値になります。 この値は、現状、どのインクルードファイルにもマクロ定義されていませんが、 EditCmds.mh を見れば分かります。
なお、指定されたキーに割り当てられているコマンドがない場合、返値は、0 になります。

　　Bit7-0:　仮想キーコード
　　Bit10: 　Shiftキー状態（ =0: OFF, =1: ON ）
　　Bit11: 　Ctrlキー状態 （ 同上 ）
　　Bit12: 　Altキー状態　（ 同上 ）

このキーコード関連のマクロ定義は、本エディタのインストール フォルダ 内の Include\GkLib\GkKey.mh に あります。

本関数は、指定されたキーに割り当てられているコマンドの識別値を返します。 但し、そのコマンドが無い場合には、0 以下の整数値を返します。
コマンドによっては、１個または２個のパラメータを伴う場合があります。 そのような場合、本関数は、そのパラメータも返します。そのため、一般的には、 本関数の返値は、次のようにして受け取ります。
　( cmd, p1, p2 ) = ::Epsaly.GetKeyCmd( key );
これで、cmd にコマンド識別値、p1 に第１パラメータ、p2 に第２パラメータ、 が代入されます。なお、第１パラメータが無い時、p1 は null になり、 第２パラメータが無い時、p2 は null になります。

スクリプトの実行対象の編集ウィンドウで、例えば、ファイルを「開く」ダイアログ ボックスを表示している時には、スクリプトからのカーソル移動やテキスト編集等の コマンドは、受け付けられません。というよりも、その実行で例外が発生します。

この Sync 関数を使えば、テキストエディタがスクリプトからのコマンドを 受け付けられる状態になるまで待つことができます。また、待たずに、その状態を 取得することもできます。

引数の msec には、最大待ち時間（単位はミリ秒）を指定します。 msec の値が 0 以下なら、待たずに、現状態を即時に返します。 msec の指定がない場合、テキストエディタがコマンドの受け付け可能になるまで待ち 続けます。但し、同期不能の場合は、その状態を即時に返します。
　Sync 関数の返値は、次の通りです。
　　+1:　同期成功（コマンド実行可能）
　　 0:　同期未完（まだ待機が必要）
　　-1:　同期不能（もはや実行不能）
なお、同期不能は、スクリプトの実行対象の編集ウィンドウが閉じられてしまっている 等の原因に依ります。

スクリプトの実行対象の編集テキストは、通常、 スクリプトの実行中でも手動で操作できるようになっています。 この Lock 関数を実行すると、その対象のテキストをロックして、 スクリプト以外では、何も操作できなくします。

このロックは、カウンタで管理されています。 このカウンタは、最初は０に初期化されていて、Lock() を実行すると１つ増加し、 Unlock() を実行すると１つ減少します。このカウンタの値が、１以上か否かで、 ロックの ON/OFF が制御されます。このカウンタの値は、負にはなりません。 スクリプトの実行が終了すると無条件に、このカウンタは０にリセットされて、 ロックは解除されます。

プログラムミス等で、万が一、ロックしたまま、スクリプトの実行が終らなくなってしまった場合、 Breakキー（Ctrl+Pauseキー）の操作で、スクリプトを強制終了させることができます。

　type = 1:　現カーソルの矩形（スクリーン座標系）
　　　　 2:　現編集ウィンドウの矩形（スクリーン座標系）
　　　　 3:　現編集ウィンドウのタイトル
　　　　 4:　ウィンドウ描画更新可否状態（ =0:禁止, =1:許可 ）
　　　　 5:　現編集ウィンドウの視点（ = 0 〜 3 ）
　　　　 6:　現編集ウィンドウのステータスバーの第１区画の文字列

  ( Xo, Yo, Xd, Yd ) = .GetWindowCond( 1 );
  ( Xo, Yo, Xd, Yd ) = .GetWindowCond( 2 );
  title = .GetWindowCond( 3 );
  state = .GetWindowCond( 4 );
  viewpt = .GetWindowCond( 5 );
  msg = .GetWindowCond( 6 );

引数 type には、設定する状態（状況）の種別を指定します。 これには、今のところ、次の４種類があります。

　type = 3:　現編集ウィンドウのタイトル
　　　　 4:　ウィンドウ描画更新可否状態（ =0:禁止, =1:許可 ）
　　　　 5:　現編集ウィンドウの視点（ = 0 〜 3 ）
　　　　 6:　現編集ウィンドウのステータスバーの第１区画の文字列

本関数の返値は、正常終了時、各 type に応じて、次のようになります。
　type = 3:　type の値自身( 3 )
　　　　 4:　その実行結果の状態（ 1 or 0 ）
　　　　 5:　視点を示す値（ 0 〜 3 ）
　　　　 6:　type の値自身( 6 )
不正終了時は、null になります。

現編集ウィンドウのタイトルとステータスバーの文字列は、本関数で変更しても、 スクリプトが終了した時点で、元の内容に戻ります。

ウィンドウ描画更新可否状態は、スクリプトの一連の処理の途中で画面が 逐次更新されないようにする場合に、その間だけ一時的に禁止します。 こうしておくと、画面更新処理の時間が省かれるので、実行時間が短縮されます。 この禁止状態を解除すると、その時点で、それまでに変更されていた内容が 一気に描画されます。 なお、この禁止状態は、スクリプトで解除していなくても、 スクリプトが終了した時点で、自動的に解除されます。

::Epsaly.TintSelText( 5 );  // 選択範囲を 5 番目の形態で着色
::Epsaly.TintSelText( 0 );  // 選択範囲の着色を解除

現編集テキスト内にある全ての汎用着色区間を列挙：

  LimCi = ::Epsaly.GetFullCn();
  for( Ci = 0 ; Ci < LimCi ; Ci += Cn )
  {
      ( Id, Cn, Ci ) = ::Epsaly.GetTintInfo( Ci'Ci );
      if( Id != 0 )   // 着色あり？
          print Id, Cn, Ci;
  }