- はじめに
- sourceについて
- kindについて
- 固有名詞
- アクションの上書きについて
- カインドの継承順序について
- アクションのファイルパスについて
- カインドの種類
- 候補のフォーマットについて
- コールバックの登録
- 連絡先
このドキュメントはUnityマクロの内部実装について書いています。
作成途中です。
候補を返す方法を指定する
値 | 説明 | 処理 |
---|---|---|
function | DLL側の関数を利用して候補を作成する | 同期 |
string | 候補を改行区切りのリストで返す | 同期 |
file | 候補をファイルから作成する | 同期 |
async_file | 候補をファイルから作成する | 非同期 |
説明を一行で記述する。
ディフォルトで呼び出すカインド
|属性|説明|ディフォルト値| |description|説明|""| |default_action|ディフォルトのアクション名|""| |base_kind|基底カインド|""|
属性 | 説明 | ディフォルト値 |
---|---|---|
is_quit | アクション実行後に終了するかどうか | false |
is_multi_selectable | 複数選択に対応したアクションかどうか | false |
is_edit | テキストを編集するアクションかどうか | false |
is_start | アクション実行後に候補を生成しアクションを開始するかどうか | false |
is_reget_candidates | アクション実行後に候補を再取得するかどうか | false |
固有名詞 | 説明 | 備考 |
---|---|---|
行番号 | 1開始の値 | |
行インデックス | 0開始の値 | 行インデックス=行番号-1 |
アクションは別のアクションを継承することが出来ます。
通常の使用例。
kinds\file.mac
default_action=open
sources\file.mac
default_kind=file <- fileカインドのopenを呼ぶ
上書きした場合の例。
kinds\file.mac
default_action=open
sources\file.mac
default_kind=file
default_action=echo <- commonアクションのechoを呼ぶ
種類 | 優先度 |
---|---|
kind | 低 |
source | 高 |
base_kind=jump_list file
default_action=open
jump_listとfileはそれぞれopenアクションを持っています、上記例ではjump_listのopenが呼ばれます。
base_kind=最高優先度 次の優先度 ... 最低優先度
アクションのパス(ディレクトリ、ファイル)を設定取得することが出来ます。
##success=dllfuncw(#g_dll_ohtorii_tools, "SetCandidateActionPath", $$file_name);
$$text=dllfuncstrw(#g_dll_ohtorii_tools,"GetSelectionActionPath",##first_item_index);
candidateの種類
- string
- file
- async_file
- function
候補を文字列から生成します。
sources\emoji.macを参照してください。
候補をファイル(同期)から生成します。
候補をファイル(非同期)から生成します。 時間のかかる処理に向いています。(c:\windows以下のファイルを列挙する場合など)
sources\file_recursive.mac を参照してください。
候補をohtorii_toolsの関数を利用して生成します。 関数を直接利用するので最も細かく制御できます。
process.mac を参照してください。
candidate_typeが以下の時のフォーマットについて。
- string
- file
- async_file
UTF16LE-BOM
ファイルフォーマットは2種類あります。
候補テキスト1
候補テキスト2
候補テキスト3
...
候補テキストN
候補に続いてタブ区切りで追加情報を並べます。
候補テキスト1 action名1 アクションに紐付いたテキスト1
候補テキスト2 action名2 アクションに紐付いたテキスト2
候補テキスト3 action名3 アクションに紐付いたテキスト3
...
候補テキストN action名4 アクションに紐付いたテキストN
以下のいずれかを指定します。
- @action_directory
- @action_filename
- @description
candidate_type | サンプルのファイル名 |
---|---|
string | sources\emoji.mac |
file | 後で用意する |
async_file | sources\file_recursive.mac |
ユーザー定義のコールバックを登録できます。
- Unityマクロ終了直前
\kinds\window.mac jump: ラベルの処理を参照してください。
コールバックの種類毎に制限があります。
以下のDLLは解放済みなので呼ぶことは出来ません。
- ohtorii_tools