browserpanecommand(Ver9.35対応版)
目次−
ブラウザ枠・個別ブラウザ枠−
browserpanecommand
browserpanecommand文/関数は、ブラウザ枠または個別ブラウザ枠に対する何らかの操作・取得・設定を文字列で指定します。(V9.22以降)
例 |
browserpanecommand "watch";
|
- パラメータ1(文字列型またはオブジェクト)
-
コマンドの文字列、JSONの文字列(またはJavaScriptのオブジェクト)のいずれかを指定します。
- 返り値(文字列)
-
"get"による取得の場合、得られる値を文字列で返します。
コマンドの文字列の場合は以下の通りです。
"get_readyState" 未完了では"loading"、DOM操作まで完了では"interactive"、すべて完了では"complete"が返ります。
"get_DOMContentLoaded" 未完了では"0"、DOM操作まで完了では"1"が返ります。
"get_load" 未完了では"0"、すべて完了では"1"が返ります。
"left" 位置を左にします。
"right" 位置を右にします。
"top" 位置を上にします。
"bottom" 位置を下にします。
"clear" クリアします。
"refresh" 更新します。
"focus" ウィンドウのフォーカスをブラウザ枠に移動します。
"focusinputfield" コンテンツ内に入力欄があれば入力欄にフォーカスを移動します。
"watch" ウォッチをONにします。(V9.25以降)
"nowatch" ウォッチをOFFにします。(V9.25以降)
"watchsave" 上書き保存で更新をONにします。(個別ブラウザ枠のみ)(V9.25以降)
"nowatchsave" 上書き保存で更新をOFFにします。(個別ブラウザ枠のみ)(V9.25以降)
"maximize" 最大化します。(個別ブラウザ枠のみ)(V9.25以降)
"restoremaximize" 最大化を解除します。(個別ブラウザ枠のみ)(V9.25以降)
"copy" コピーします。(V9.25以降)
//例
setbrowserpanetarget "_each";
browserpanecommand "watch";
endmacro;
//例
js{
setbrowserpanetarget( "_each" );
browserpanecommand( "watch" );
}
endmacro;
JSON/オブジェクトの場合のプロパティの意味は以下の通りです。
target: 対象となる枠の名前。"_common"は共通のブラウザ枠。"_each"は個別ブラウザ枠。記述が無い場合は既定の枠が対象。
show: 1を指定すると表示します。0を指定すると、非表示にしてインスタンスが無くなります。(コンテンツが閉じます)
invisible: 見えないようにするかどうか。1で見えない。0で見える。非表示にしてもインスタンスは継続します。
uri: URI。(urlでも可)
place: 位置。"leftside" "rightside" "upside" "downside"のいずれか。
get: 情報を取得します。target以外の他のプロパティは無視されます。(後述)
clear: 1を指定するとクリアします。
focus: 1を指定するとウィンドウのフォーカスをブラウザ枠に移動します。
size: 上下左右の枠の配置のときのピクセル単位のサイズの数値。
syncsize: 1を指定すると枠のサイズを他の秀丸エディタにも反映させます。
initialize: 個別ブラウザ枠の場合、"async"を指定すると初期化を待機せずにすぐに制御を戻します。
watch: ウォッチの状態を0か1で指定します。(1を指定するとローカルファイルの自動更新)
watchsave: [上書き保存で更新]の状態を0か1で指定します。(1を指定すると[上書き保存で更新]をON)(V9.25以降)
setinputfield: 文字列を指定して、コンテンツ内のフォーカスのある要素が入力欄であれば設定します。(内容によってはうまくいくとは限りません)
//例
browserpanecommand """
{
"target": "_each",
"watch": 1,
}
""";
endmacro;
//例
js{
browserpanecommand({
target: "_each",
watch: 1,
});
}
endmacro;
JSONの/オブジェクトのgetプロパティで関数として呼ばれたときに、取得したい情報を以下の値で指定します。
"readyState" 未完了では"loading"、DOM操作まで完了では"interactive"、すべて完了では"complete"が返ります。
"DOMContentLoaded" 未完了では"0"、DOM操作まで完了では"1"が返ります。
"load" 未完了では"0"、すべて完了では"1"が返ります。
"show" 表示されている場合"1"、非表示の場合インスタンスの有無に関わらず"0"が返ります。
"invisible" 見えない状態の場合"1"、見える状態の場合"0"が返ります。(V9.25以降)
"uri" URIが返ります。(urlでも可)
"size" 上下左右の枠の配置のときのピクセル単位のサイズが文字列として返ります。
"place" 位置を返します。"leftside" "rightside" "upside" "downside" "overlay"のいずれかです。
"initialized" 初期化が完了している場合に"1"、そうでなければ"0"が返ります。(initialize: "async"の場合だけに意味がある)(個別ブラウザ枠のみ)
"title" タイトルが返ります。
"watch" ウォッチの状態を返します。(V9.25以降)
"watchsave" [上書き保存で更新]の状態を返します。(V9.25以降)
"maximize" 最大化の状態を返します。(V9.25以降)
//例
$strUri = browserpanecommand( """
{
"target": "_each",
"get": "uri",
}
""" );
message $strUri;
endmacro;
//例
js{
strUri = browserpanecommand({
target: "_each",
get: "uri",
});
message( strUri );
}
endmacro;
//例
js{
fInvisible=Number(browserpanecommand({target:"_each",get:"invisible"}));
browserpanecommand({target:"_each",invisible:!fInvisible});
}
endmacro;
まとめて指定できます。
//例1
browserpanecommand """
{
"target": "_common",
"show": 1,
"uri": "https://hide.maruo.co.jp/",
"place": "leftside",
}
""";
endmacro;
//例2
js{
browserpanecommand({
target: "_each",
show: 1,
uri: "https://hide.maruo.co.jp/",
place: "leftside",
});
}
endmacro;