プラグインコーディングガイド

　アウトライン解析プラグインは、アウトライン解析ダイアログを表示する際に一度だけ呼びだされる。プラグインコードは、編集中文書の先頭から1行ずつ読み取り、条件に合致すればOutlineオブジェクトの AddFuncInfo, AddFuncInfo2関数でアウトライン解析ダイアログに登録する。
　アウトライン解析ダイアログはあらかじめ提供されている中から適当なものをOutline.SetListType関数で選択する。ダイアログのタイトルはOutline.SetTitle関数で指定できる。

<疑似コード>

Outline.SetListType( タイプ )            # タイプ: 4.2.3章を参照。
Outline.SetTitle( 'タイトル文字列' )
行数 ← Editor.GetLineCount( 0 )
ループ： 1 ≦ カウンタ ≦ 行数
    行 ← Editor.GetLineStr( カウンタ )  # 行末にEOLが1byte付加されていることに注意。
    もし： 行 が 条件 に当てはまるなら
        Outline.AddFuncInfo(
            カウンタ,                    # 論理行番号
            1,                           # 論理桁番号
            '文字列',                    # ダイアログに表示する文字列
            付加情報)                    # 追加行の種別を表す整数値
                                         # 
    もし：終わり
    カウンタ ← カウンタ + 1
ループ：終わり

※タイプで 3:汎用のツリー表示を選択した場合は、AddFuncInfoの代わりにAddFuncInfo2関数を使用する。その場合、第4引数には階層を表す整数値を渡す。
※付加情報はタイプによって以下のように解釈される。

・タイプ 200:クラスツリーの場合
0	: 定義位置	… 無視される
1	: 宣言	… クリップボードにコピーしても付加される
2	: 通常の関数
3	: クラス	… 不明なトップレベル要素は 3 扱い(または 7 名前空間)になる
4	: 構造体
5	: 列挙体
6	: 共用体
7	: 名前空間	… 前述
8	: インタフェース
9	: グローバル	… トップレベルに 3 や 7 以外が来ると生成
・タイプ 8:VB関数一覧の場合
1	: 宣言
10	: 関数宣言
20	: プロシージャ宣言
11	: 関数
21	: プロシージャ
31	: ■パッケージ仕様部
41	: ■パッケージ本体部
50	: PROC
51	: ラベル
52	: ENDP

※またリスト表示で付加情報に0x10000を加えると、その行はクリップボードコピーの対象外となる。

アウトラインプラグインで、タイプに200を指定するとJavaなどoo言語のクラスを表示できますが、「Sakura 構造体」の「構造体」ように後ろにつく文字はJava/C++の固定のものしか選べません。
SetLabelはプラグインから付加文字列を変更・追加できるようにします (Ver.2.0.9.0以降)。

<例>

Outline.SetListType( 200 ); //Javaツリー
Outline.SetLabel( 2, " メソッド" ); //2番「 メソッド」に変更
Outline.SetLabel( 10, " モジュール" ); //10番「 モジュール」を追加
Outline.AddFuncInfo( 1, 1, "Foo", 10 ); //モジュール
Outline.AddFuncInfo( 3, 1, "Foo::Bar::Hoge", 2 ); //関数
Outline.AddFuncInfo( 5, 1, "Foo::Bar::Fuga", 2 ); //関数

以下のようになる。
　- Foo モジュール
　　　- Bar クラス
　　　　　- Hoge メソッド
　　　　　- Fuga メソッド

スマートインデント(ジャック名：SmartIndent)

　スマートインデントプラグインは、キーボードの文字キーを押下してから実際に文字が表示されるまでの間に毎回呼びだされる。プラグインコードは、編集中文書の先頭から1行ずつ読み取んで、現在行で適切なインデント幅を判断してスペースまたはタブを出力する。キー入力ごとにプラグインを呼び出すため、WSHプラグインなら負荷軽減のためUseCacheを1にしたほうがよい。

　Enterキーが入力された場合、カーソルが次の行に移動した状態でプラグインが呼び出される。またタイプ別設定の自動インデントが有効の場合、自動インデント後の状態でプラグインが呼び出される。改行されたかどうかは論理桁が1であるかで判定するため、自動インデントはオフにしてもらう必要がある。

<疑似コード>

現在行 ← Editor.ExpandParameter("$y")
現在桁 ← Editor.ExpandParameter("$x")
もし： 現在桁 が 1 でないなら
    処理終了                             # 改行のみをインデントタイミングとする場合
もし：終わり
行数 ← Editor.GetLineCount( 0 )
ループ： 1 ≦ カウンタ ≦ 行数
    もし： カウンタ が 現在行 なら
        Editor.InsText( '適切なインデント文字列' )
        処理終了
    もし： 終わり
    カウンタ ← カウンタ + 1
ループ：終わり

補完候補検索・・・ (Ver.2.0.6.0以降)

エディタイベント・・・ (Ver.2.0.8.0以降)

≪ジャック≫

EditorStart	新しいエディタウィンドウを開いて初期化完了後に呼ぶ。
EditorEnd	エディタウィンドウを閉じる前に呼ぶ。
DocumentOpen	ファイルを開いた後に呼ぶ。
DocumentClose	ファイルを閉じる前に呼ぶ。(保存確認の後)
DocumentBeforeSave	ファイルを保存する前に呼ぶ。
DocumentAfterSave	ファイルを保存した後に呼ぶ。

アウトラインのようにタイプ別設定で選んだものが動くということはなく、どんなタイプでも【アウトプット】でも【Grep】だろうと発動する。
動く順番は、EditorStart→ DocumentOpen→ DocumentBeforeSave→ DocumentAfterSave→ DocumentClose→ EditorEndが基本です。
名前をつけて保存なら、DocumentBeforeSave→ DocumentClose(旧)→ DocumentAfterSave→ DocumentOpen(新)となる。

プラグインの初期化・終了処理や、ファイル保存後の後処理なんかにどうでしょうか。

ComplementGlobal	全てのタイプに適用される補完候補検索
Complement	タイプ別設定「支援」の選択肢に追加される補完候補検索