aboutsummaryrefslogtreecommitdiffstats
path: root/doc-jp/README.menu
diff options
context:
space:
mode:
Diffstat (limited to 'doc-jp/README.menu')
-rw-r--r--doc-jp/README.menu106
1 files changed, 106 insertions, 0 deletions
diff --git a/doc-jp/README.menu b/doc-jp/README.menu
new file mode 100644
index 0000000..0cb8424
--- /dev/null
+++ b/doc-jp/README.menu
@@ -0,0 +1,106 @@
+
+w3m のメニューについて
+ (2002/11/27) 坂本 浩則
+ hsaka@mth.biglobe.ne.jp
+
+[1] キー操作
+
+ ・一般的なもの
+
+ HELP, INS キー : メニューの立ち上げ
+ HELP, INS キー, C-c, : メニューの消去
+ RET(C-m, C-j), SPC, →キー : 選択
+ BS(C-h), DEL(C-?), ←キー : 戻る
+ C-n, j, ↓キー : 下の項目へ
+ C-p, k, ↑キー : 上の項目へ
+ J : 項目を上にスクロール
+ K : 項目を下にスクロール
+ C-a : 先頭の項目へ
+ C-e : 最後の項目へ
+ C-f, C-v : 次ページの項目へ
+ C-b, M-v : 前ページの項目へ
+ C-s, / : 項目を下に向かって検索
+ C-r, ? : 項目を上に向かって検索
+ n : 次の項目を検索
+ N : 前の項目を検索
+ C-z : サスペンド
+
+ # INS は通常 ^[[2~ ですが ^[[L(コンソール), ^[[E(PocketBSD) にも
+ バインドしてあります。
+
+ MenuKeymap, MenuEscKeymap, MenuEscBKeymap, MenuEscDKeymap (menu.c)
+ で定義
+
+ ・個別のメニュー用
+
+ MenuItem 構造体 (menu.h) の char *keys に設定(複数可能)
+ 上記のキー操作に上書きされます。
+
+[2] マウス
+
+ ボタン3 : メニューの立ち上げ
+
+ 立ち上げ後
+
+ ボタン1/3 (項目) : 選択
+ ″ (枠,MENU_NOP) : 何もしない
+ ″ (枠外) : 戻る(メニューの消去)
+ ″ ( : ) : 次ページまたは前ページの項目へ
+ (長いメニューの場合)
+ ″ (ドラッグ) : スクロール
+
+[3] メニューのカスタマイズ
+
+ ~/.w3m/menu にメニューを定義できます。
+ メニューは、
+
+ menu MENU_ID
+ 項目
+ :
+ end
+
+ として設定します。各項目には、
+
+ func LABEL FUNCTION KEYS [DATA] コマンド実行
+ popup LABEL MENU_ID KEYS サブメニュー立ち上げ
+ nop LABEL 何もしない(セパレータやタイトル)
+
+ を設定可能です。
+ 例は menu.default や menu.submenu を見てください。
+ 設定できるコマンド(FUNCTION)は README.func を見てください。
+ MENU_ID として "Main" はメインメニューに、"Select" はバッファ選択
+ メニューに、"SelectTab" はタブ選択メニューに予約されています。
+ KEYS はバインドするキーで複数指定可能です。
+ DATA が設定されていればコマンド(FUNCTION)の引数として使われます。
+
+[4] 開発について
+
+ メニュールーチンの例は mainMenu(), optionMenu() を見れば分かると思います。
+ このルーチンと以下の MenuItem 構造体を定義すれば、ほとんどのメニューは、
+ 設定できると思います。
+
+ MenuItem 構造体 (menu.h)
+
+ struct {
+ int type; /* タイプ */
+ char *label; /* ラベル */
+ int *variable; /* VALUE_MENU の場合に設定する変数 */
+ int value; /* VALUE_MENU の場合に設定する値 */
+ void (*func)(); /* 選択された時に実行する関数 */
+ struct _Menu *popup; /* サブメニュー */
+ char *keys; /* バインドするキー(複数可能) */
+ } MenuItem;
+
+ タイプ type は以下のものが使用できます。
+
+ MENU_NOP (1) : なにもしない。選択もできない。
+ (タイトルやセパレータ用)
+ MENU_FUNC (2) : 関数を実行
+ MENU_VALUE (4) : 変数(*variable)に値(value)を設定
+ MENU_POPUP (8) : サブメニューを立ち上げる
+
+ MENU_FUNC と MENU_VALUE は (MENU_FUNC | MENU_VALUE) と
+ 設定することで両方の動作をします。(変数設定が先です)
+
+ 設定例は、MainMenuItem (menu.c) や new_option_menu() を見てください。
+