ステップのパラメーター
ステップを選択すると、その下にフィールドが開きます。ステップに必要な詳細ごとに 1 つずつです。各フィールドにはわかりやすい言葉のラベルが付いています。フィールドをポイントすると、その用途を説明するツールヒントが表示されます。
フィールドの種類
| フィールド | 見た目 | 受け付けるもの |
|---|---|---|
| テキスト | テキスト ボックス | 任意のテキスト |
| 整数 | テキスト ボックス | 250 や -3 のような整数、0xB3 のような 0x で始まる 16 進数、または VirtualKey.MediaPlayPause のような名前付き定数 |
| 数値 | テキスト ボックス | 地域の形式にかかわらず、ピリオドを小数点とする 0.5 のような数値 |
| true または false | スイッチ | オン (true) またはオフ (false) |
| 名前付きの値の選択肢 | ドロップダウン ② | MouseButton.Primary のような一覧の名前のいずれか。入力することもできます |
| ウィンドウ | テキスト ボックス | 値のメニューまたは変数からのウィンドウ。通常は 対象ウィンドウ |
| キー (キーを送信) | キーの入力ボックス | 押したキーの組み合わせ |
どの種類のフィールドでも、$ と変数の名前を入力して、前のステップが保存した値を使うことができます (変数)。
ステップのフィールドの数値では、地域の形式にかかわらず、常にピリオドを小数点として使い、桁区切り記号は使いません。
名前付き定数
整数または数値のフィールドでは、名前付き定数 (名前空間、ドット、名前。たとえば VirtualKey.MediaPlayPause や AudioEndpoint.Playback) も使えます。スクリプトで使うのと同じ名前です (名前付き定数)。大文字と小文字を同じにし、空白を入れずに正確に入力してください。ステップは名前を保存し、アクションは実行時にその数値を使います。テキストのフィールドでは、そのような名前は入力したとおりのテキストとして保持されます。
キーのフィールド
キーを送信 には、テキスト ボックスの代わりにキーの入力ボックスがあります。クリックし (クリックしてショートカットを設定)、組み合わせを押します。記録されるのは組み合わせだけで、設定中には何も送られません。メディア キーなど、キーの組み合わせで表せないキーは、メッセージと共に拒否されます。それらを押すには、VirtualKey.MediaPlayPause のようなキーの名前を指定して キーを押して離す ステップ (KeyboardPressKey) を使います (実例のレシピ)。
新しいステップは入力済みの状態で始まる
新しいステップの ウィンドウ のフィールドは 対象ウィンドウ で始まります。これは、ジェスチャを描いた場所のウィンドウ、またはホットキーや入力テキストの場合はフォーカスのあるウィンドウです。スイッチはオフで始まります。それ以外のフィールドは空で始まるので、入力してください。
メニューから値を選ぶ
キー とスイッチ以外のすべてのフィールドには、末尾に小さな矢印 (値を選択) があります。これを使うと、フィールドに合う値のメニューが開きます ①。ステップ自体のフィールドのほかに、条件の 値 と 比較対象 のフィールドとその単独の 値 (条件)、繰り返しの 回数 (ステップの繰り返し)、変数を設定 ステップの 値 (変数) にもメニューがあります。
| セクション | 値 |
|---|---|
| アクションのきっかけから | 対象ウィンドウ、対象コントロール、ジェスチャ名、アクション名、アプリ グループ名、ジェスチャのボタン、およびジェスチャの ジェスチャの左端、ジェスチャの上端、ジェスチャの幅、ジェスチャの高さ |
| ステップの実行時に取得 | アクティブ ウィンドウ、マウスの X 位置、マウスの Y 位置、クリップボードのテキスト、現在の日時 |
| 前のステップで保存した値 | このステップより上のステップが保存する変数 |
メニューには、フィールドの種類に合う値だけが表示されます。数値のフィールドは整数も受け付け、何でも受け付けるフィールドはすべてを受け付けます。回数 には整数だけが表示されます。条件のフィールドと 変数を設定 の値には、すべての読み取り値が表示されます。合うものがない場合、メニューには このフィールドで選べる値はありません と表示されます。
選んだ値は、テキスト ボックスの代わりに名前の付いたチップとして表示されます。チップをポイントすると、それが何であるかと、スクリプトでの書き方が表示されます。チップの クリア ボタンでフィールドが空になり、再び入力できます。
アクションのきっかけから の値は、トリガーを読み取ります。ホットキーや入力テキストで開始されたアクションでは、ジェスチャの値は空または 0 です。スニペットはどこからでも呼び出せるため、ステップが実行されるどの場所でもすべての値が表示されます。
スイッチでは、以前に入力した変数がチップとして表示されます。チップをクリアすると、スイッチはオフになります。
入力中の確認
各フィールドは、入力中に確認されます。問題がある場合は、フィールドの下に赤で表示され、フィールドの枠が赤になります。
| メッセージ | 意味 |
|---|---|
| この値は必須です。 | 変数を設定 ステップの変数名が空です。 |
| 整数 (10 進数または 0x 形式の 16 進数)、名前付き定数、あるいは $変数 を入力してください。 | 整数のフィールドにそれ以外のものが入っています。 |
| この名前の名前付き定数はありません。VirtualKey.MediaPlayPause のように、つづりと大文字・小文字を確認してください。 | 整数または数値のフィールドに、名前付き定数ではない、名前空間、ドット、名前が入っています。 |
| 数値、あるいは $変数 を入力してください。 | 数値のフィールドにそれ以外のものが入っています。 |
| true または false、あるいは $変数 を入力してください。 | テキストとして入力された true/false のフィールドに、それ以外のものが入っています。 |
| ステップでは引数の中で組み込み関数を実行できません。先に変数に移動してください。 | フィールドに、かっこの中に何かがある組み込み関数の呼び出しが入っています (下記)。 |
整数や数値のフィールドの文字、名前付き定数ではない名前、true/false のフィールドの true と false 以外のものなど、確認に通らない入力テキストがフィールドにある間は、ステップは保存されません。アクションは最後に保存されたステップを保持し、フィールドを修正するまで、一覧の下に ステップは保存されませんでした: ステップ N に無効なフィールドがあります と表示されます (問題)。
空のフィールドにはメッセージは表示されず、保存を妨げることもありません。ステップはフィールドが空のまま保存されます。アクションの実行時に、数値、true/false、ウィンドウのフィールドが空のステップがあると、アクションはそこで停止し、コンソールの システム の出力に、その引数の型が誤っていることが示されます。空のテキストのフィールドは空のテキストとして実行され、一部の組み込み関数 (ファイル名、探すウィンドウのタイトル) では、そのステップは何もしないことになります。
変数に移動する
フィールドに入るのは、値、変数、または値のメニューの読み取り値のいずれかで、引数付きの組み込み関数の呼び出しは入りません。WindowGetTitle($w) のような呼び出しを入力すると、フィールドに 変数に移動 が表示されます。これを使うと、その呼び出しを実行して結果をフィールドから取った名前 (window、次は window2 など) で保存するステップがこのステップのすぐ上に追加され、フィールドにはその変数が入ります。
ClipboardGetText() のようにかっこの中が空の呼び出しは問題ありません。値のメニューでその読み取り値を選ぶのと同じです。これは、条件のフィールド、回数、変数を設定 の値を含め、値のメニューがあるすべてのフィールドで同じです。
ステップの結果を保持する
ほとんどの組み込み関数は結果を返します。読み取ったテキスト、見つけたウィンドウ、成功したかどうかなどです。結果の保存先 ③ でそれを名前で保持すると、後のステップで $name として使えます。結果を無視するには空のままにします。
結果を保持するステップでは、概要の末尾に「→ $name」が表示されます。名前は変数のルールに従います。
実行時の型の誤り
エディターが確認するのは入力内容の形であり、組み込み関数のすべてのルールではありません。アクションの実行時に、型の誤った値 (たとえば、組み込み関数が整数を必要とする場所でテキストを保持している変数) や、組み込み関数が拒否する値があると、アクションは診断コンソールにエラーを出して停止します。エラーを参照してください。