Skip to content

Commit 5f9db59

Browse files
h-easth-east
authored
Merge pull request #1097 from tsuyoshicho/update/20220524/testing
Update testing.{txt,jax}
2 parents 1b8cc0b + 7e290af commit 5f9db59

File tree

2 files changed

+261
-145
lines changed

2 files changed

+261
-145
lines changed

‎doc/testing.jax

Lines changed: 130 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
*testing.txt* For Vim バージョン 8.2. Last change: 2021 Dec 11
1+
*testing.txt* For Vim バージョン 8.2. Last change: 2022 May 16
22

33

44
VIMリファレンスマニュアル by Bram Moolenaar
@@ -65,9 +65,9 @@ test_garbagecollect_now() *test_garbagecollect_now()*
6565
garbagecollect() とほぼ同じであるが、この関数はガーベッジコレ
6666
クトを直ちに実行する。この関数を実行する場合は、構造体が内部に
6767
存在しないようにするために直接呼び出す必要がある。また、この関
68-
数を呼び出す前に |v:testing| を設定する必要がある。これは、ス
69-
タック上の変数が解放されるため、:def 関数から呼び出された場合
70-
には動作しない。
68+
数を呼び出す前に |v:testing| を設定する必要がある。 *E1142*
69+
これは、スタック上の変数が解放されるため、:def 関数から呼び出
70+
された場合には動作しない。
7171

7272
test_garbagecollect_soon() *test_garbagecollect_soon()*
7373
あたかもメインループの中にいるように、ガーベッジコレクトを呼び
@@ -82,46 +82,120 @@ test_getvalue({name}) *test_getvalue()*
8282
|method| としても使用できる: >
8383
GetName()->test_getvalue()
8484
<
85-
*test_gui_drop_files()*
86-
test_gui_drop_files({list}, {row}, {col}, {mods})
87-
{list} の1つ以上のファイルをウィンドウの {row} 行 {col} 列にド
88-
ロップする。この関数は |drop_file| 機能が存在するGUI版の Vim
89-
でのみ動作する。
90-
91-
{mods} としてサポートされる値:
92-
0x4 Shift
93-
0x8 Alt
94-
0x10 Ctrl
95-
ファイルは引数リスト |argument-list| に追加され、{list} の最初
96-
のファイルの編集がウィンドウで開始される。詳細は |drag-n-drop|
97-
を参照。
98-
99-
*test_gui_mouse_event()*
100-
test_gui_mouse_event({button}, {row}, {col}, {multiclick}, {modifiers})
101-
マウスボタンのクリックイベントを注入する。この関数はGUIで実行
102-
している時のみ動作する。
103-
{button} としてサポートされる値:
104-
0 右マウスボタン
105-
1 中央マウスボタン
106-
2 左マウスボタン
107-
3 マウスボタンリリース
108-
4 スクロールホイール下
109-
5 スクロールホイール上
110-
6 スクロールホイール左
111-
7 スクロールホイール右
112-
{row} と {col} はマウスクリックの位置を指定する。Vimウィンドウ
113-
で最初の行は1で最後の行は 'lines' である。{col} の最大値は
114-
'columns' である。
115-
マルチクリックイベントを注入するには、{multiclick} に1を設定す
116-
る。
117-
{modifiers} としてサポートされる値:
118-
4 shiftキーが押されている
119-
8 altキーが押されている
120-
16 ctrlキーが押されている
121-
マウスイベントの注入後、処理のためにおそらく |feedkeys()| を呼
122-
ぶ必要があるだろう。例: >
85+
*test_gui_event()*
86+
test_gui_event({event}, {args})
87+
機能テストしているVimで GUI のイベント {event} を引数 {args}
88+
で生成する。この関数は GUI で動作している場合のみ動作する。
89+
90+
{event} は文字列でサポートする値は:
91+
"dropfiles" 1つ以上のファイルをウィンドウへドロップ。
92+
"findrepl" テキストの検索と置換。
93+
"mouse" マウスのボタンクリックイベント。
94+
"scrollbar" スクロールバーの移動もしくはドラッグ。
95+
"tabline" マウスクリックによるタブページ行の選択。
96+
"tabmenu" タブページ行のメニューエントリの選択。
97+
98+
引数 {args} はイベントの引数を持つ辞書。
99+
100+
"dropfiles":
101+
指定したウィンドウへ1つ以上のファイルのドロップ。{args} でサ
102+
ポートする項目は:
103+
files: ファイル名のリスト
104+
row: ウィンドウの行番号
105+
col: ウィンドウの桁番号
106+
modifiers: 修飾キー。サポートする値は:
107+
0x4 Shift
108+
0x8 Alt
109+
0x10 Ctrl
110+
この(複数)ファイルは引数リスト |argument-list| に追加され、
111+
{files} の最初のファイルがウィンドウで編集状態になる。詳細な
112+
情報は |drag-n-drop| を参照。このイベントは |drop_file| 機能
113+
が有効な場合のみ動作する。
114+
115+
"findrepl":
116+
{検索/置換ダイアログを持つ GUI のときのみ有効}
117+
テキストの検索と置換を行う。{args} でサポートする項目は:
118+
find_text: 検索する文字列。
119+
repl_text: 置換する文字列。
120+
flags: 検索/置換を制御するフラグ。サポートする値は:
121+
1 次の文字列を検索(検索ダイアログ)
122+
2 次の文字列を検索(置換ダイアログ)
123+
3 1度だけ文字列を置換
124+
4 全マッチの置換
125+
8 完全一致した単語のみマッチ
126+
16 マッチする大文字小文字状態
127+
forward: 1を設定すると前方への検索。
128+
129+
"mouse":
130+
マウスのクリック、あるいはマウスの移動のイベントを注入する。
131+
{args} でサポートする項目は:
132+
button: マウスボタン。サポートする値は:
133+
0 右マウスボタン
134+
1 中央マウスボタン
135+
2 左マウスボタン
136+
3 マウスボタンリリース
137+
4 スクロールホイール下
138+
5 スクロールホイール上
139+
6 スクロールホイール左
140+
7 スクロールホイール右
141+
row: マウスクリックの行番号。Vimのウィンドウの最初
142+
の行は1で最後の行は 'lines' になる。
143+
col: マウスクリックの桁番号。{col} の最大値は
144+
'columns' になる。
145+
multiclick: 1を設定すると複数のマウスクリックを注入する。
146+
modifiers: 修飾キー。サポートする値は:
147+
4 shiftキーが押されている
148+
8 altキーが押されている
149+
16 ctrlキーが押されている
150+
move: オプション; 真の場合、マウス移動イベントを生成
151+
させることができる。
152+
{args} の row: と col: だけが使われ、必須であ
153+
る。これらは、"cell" に応じて、ピクセルまたは
154+
スクリーンセルとして解釈される。
155+
'mousemoveevent' が設定されているか、ポップアッ
156+
プがマウス移動イベントを使用している場合にのみ
157+
イベントを発生させる。
158+
cell: オプション: 存在し真の場合 "move" はピクセル位
159+
置の代わりにスクリーンのセル位置を使う
160+
161+
"scrollbar":
162+
左、右あるいは水平スクロールバーの設定もしくはドラッグ。スク
163+
ロールバーが実際に存在する時のみ動作する。{args} でサポート
164+
する項目は:
165+
which: スクロールバー。サポートする値は:
166+
left 現在のウィンドウの左スクロールバー
167+
right 現在のウィンドウの右スクロールバー
168+
hor 水平スクロールバー
169+
value: スクロール量。垂直なスクロールバーの場合、値は
170+
1からバッファの行数になる。水平スクロールバー
171+
の場合、'wrap' が設定されていないと仮定すると、
172+
値は1から最大行長までの間になる。
173+
dragging: 1はスクロールバーをドラッグし、0はスクロール
174+
バーをクリックする。
175+
176+
"tabline":
177+
タブページ行のマウスクリックイベントの注入によるタブページの
178+
選択。{args} でサポートする項目は:
179+
tabnr: タブページ番号
180+
181+
"tabmenu":
182+
タブページ行のメニュー項目の選択イベントの注入。{args} でサ
183+
ポートする項目は:
184+
tabnr: タブページの番号
185+
item: タブページメニュー項目の番号。1で最初のメニュー
186+
項目、2で2番目の項目になる。
187+
188+
GUI イベントを注入した後、おそらく |feedkeys()| を呼び出してそ
189+
れらを処理する必要がある。例: >
123190
call feedkeys("y", 'Lx!')
191+
<
192+
イベントが正常に追加された場合は TRUE を返し、失敗した場合は
193+
FALSE を返す。
194+
195+
|method| としても使用できる: >
196+
GetEvent()->test_gui_event({args})
124197
198+
<
125199
test_ignore_error({expr}) *test_ignore_error()*
126200
{expr} を含むすべてのエラーを無視する。代わりに通常メッセージ
127201
が表示される。
@@ -189,23 +263,27 @@ test_override({name}, {val}) *test_override()*
189263
置き換える。Vimをテストするためだけに使用すること!
190264
置き換えは、{val} が非 0 のときに有効化され、{val} が 0 のとき
191265
に取り除かれる。
192-
現在、name に使える値は:
266+
現在、{name} に使える値は:
193267

194-
name {val} が非 0 のときの効果 ~
195-
redraw redrawing() 関数を無効化する
196-
redraw_flag RedrawingDisabled フラグを無視する
268+
{name} {val} が非 0 のときの効果 ~
269+
autoload `import autoload` でスクリプトを正しい手順でロード
270+
し、項目が使用されるまで延期はしない
197271
char_avail char_avail() 関数を無効化する
198-
starting "starting" 変数を初期化する、以下を参照
199272
nfa_fail 古い正規表現エンジンに戻すために、NFA regexp エン
200273
ジンを失敗させる
201274
no_query_mouse "dec" 端末のマウス位置を問い合わせない
202275
no_wait_return "no_wait_return" フラグを設定する。"ALL" では
203276
復元されない
204-
ui_delay ui_delay() で使用するミリ秒単位の時間; メッ
205-
セージの最大3秒の待ち時間を上書きする。
277+
redraw redrawing() 関数を無効化する
278+
redraw_flag RedrawingDisabled フラグを無視する
279+
starting "starting" 変数を初期化する、下記参照
206280
term_props バージョン文字列が検出された場合、すべてのター
207281
ミナルプロパティをリセットする。
282+
ui_delay ui_delay() で使用するミリ秒単位の時間; メッ
283+
セージの最大3秒の待ち時間を上書きする。
208284
uptime sysinfo.uptime を上書きする
285+
vterm_title 端末ウィンドウ内でジョブが走っている場合にウィン
286+
ドウタイトルを設定する
209287
ALL すべての置き換えをクリアする ({val} は使われない)
210288

211289
"starting" は、起動が完了したようにテストが振る舞うべきときに
@@ -230,28 +308,6 @@ test_refcount({expr}) *test_refcount()*
230308
GetVarname()->test_refcount()
231309
232310
233-
test_scrollbar({which}, {value}, {dragging}) *test_scrollbar()*
234-
スクロールバーを使ってそれを {value} の位置に移動させる。
235-
{which} は次のようになる:
236-
left カレントウィンドウの左スクロールバー
237-
right カレントウィンドウの右スクロールバー
238-
hor 水平スクロールバー
239-
240-
垂直スクロールバーの場合、{value} は1からバッファの行数までの
241-
値を取りうる。水平スクロールバーの場合、'wrap' が設定されてい
242-
ないと仮定すると、{value} は1から最大行の長さまでの値を取りう
243-
る。
244-
245-
{dragging} がゼロ以外の場合は、スクロールバーをドラッグするの
246-
と同じである。それ以外の場合は、スクロールバーをクリックするの
247-
と同じである。
248-
{which} スクロールバーが実際に存在し、GUIを使用している場合に
249-
のみ動作する。
250-
251-
|method| としても使用できる: >
252-
GetValue()->test_scrollbar('right', 0)
253-
254-
255311
test_setmouse({row}, {col}) *test_setmouse()*
256312
次のマウス操作に使用するマウス位置を設定する。
257313
{row} と {col} は 1ベースである。
@@ -343,7 +399,7 @@ assert_fails({cmd} [, {error} [, {msg} [, {lnum} [, {context}]]]])
343399
{cmd}を実行しエラーを生成しなかった場合か、エラーメッセージの
344400
中に{error}が見つからない場合、|v:errors| にエラーメッセージを
345401
追加する。|assert-return| も参照。
346-
402+
*E856*
347403
{error}が文字列である場合、最初に報告されたエラーの中から文字
348404
通り見つからなければならない。例えば、"E123:" の場合、多くの場
349405
合、これはコロンを含むエラーコードになる: >
@@ -364,11 +420,11 @@ assert_fails({cmd} [, {error} [, {msg} [, {lnum} [, {context}]]]])
364420
<
365421
{msg} が空の場合は利用されない。引数 {lnum} を渡す時にデフォル
366422
トメッセージを取得するにはこれを使うこと。
367-
423+
*E1115*
368424
{lnum} が非負数で設定され、引数 {error} が設定されてマッチした
369425
時、エラーが報告されるときの行番号と比較される。行番号は関数内
370426
かスクリプト内での行番号になる。
371-
427+
*E1116*
372428
{context} が存在すると、 パターンとして使われ {lnum} が位置する
373429
コンテキスト (スクリプト名か関数名) に対してマッチする。
374430

0 commit comments

Comments
 (0)