サンドボックス
サンドボックス ページは練習用の場所です。仮のデスクトップに仮のウィンドウを並べ、ステップを作成して実行します。エンジンは仮のウィンドウに対してだけステップを実行し、起こったことを返します。ページはそれを 1 ステップずつ再生します。実際のデスクトップには何も触れません。仮のウィンドウは絵であり、実際のウィンドウではありません。
① ステップを実行します。② 仮のデスクトップ。③ 実行する内容と、実行の開始時の状態。
仮のデスクトップ
デスクトップには 1 つまたは 2 つの画面と、代役と呼ばれる最大 16 個の仮のウィンドウがあります。初めてページを開くと、いくつかの代役と短い例を含む 練習用デスクトップ のレイアウトが入っています。
- 代役をクリックすると 選択 されます。デスクトップの空いている部分をクリックすると選択が解除されます。タイトル バーをドラッグすると移動し、角をドラッグするとサイズが変わります (通常 の状態のときのみ)。
- 選択した代役にはツール バーがあります: ウィンドウの設定、このウィンドウ上でジェスチャを開始、前面へ、背面へ、複製、削除。
- ウィンドウの設定 では、タイトル、クラス名、プログラム名、位置とサイズ、状態 (通常、最小化、最大化)、常に手前に表示 を設定します。タイトル、クラス、プログラムでウィンドウを探すステップは、これらの値で代役を見つけます。
- 1 つの代役には ジェスチャ バッジが付いています。実行はその代役の上でジェスチャを描いたかのように動作するため、それが 対象ウィンドウ です。実行の開始時には、表示されている最も前面の代役にフォーカスがあり、ポインターはジェスチャのウィンドウの中央にあります。
- 最小化された代役は、元に戻ったときの位置に淡く描かれるため、引き続き選択できます。
- ウィンドウを追加 で代役を追加します。
各画面の右下隅には、「メイン画面 · 1920 × 1080」のようなチップがあります。クリックすると画面のサイズを設定できます。2 台目の画面のチップには 画面を削除 もあります。画面が 1 つの場合は、画面を追加 で 1 台目の右に 2 台目が追加されます。
詳細モード。 画面の設定には、拡大縮小 (100～500 %) と フレンドリ名 もあり、デバイス パス も表示されます。スクリプトは、デバイス パスまたはこの名前で画面を見つけられます。
画面の位置は反転しないため、デスクトップはどの言語でも常に左から右に描かれます。
キーボードを使う
Tab キーで代役間を移動します。フォーカスのある代役が選択されます。方向キーで 10 ピクセル (Ctrl キーを押しながらでは 1 ピクセル) 移動し、Shift+方向キーでサイズを変更し、Enter キーまたは F2 キーで設定を開き、Delete キーで削除します。Esc キーで設定ボックスを閉じます。
レイアウト
レイアウトは、代役、画面、開始時のクリップボード、メッセージ ボックスへの応答を含むデスクトップです。レイアウト の一覧からレイアウトを選びます。その横の レイアウトのオプション ボタンには、新しいレイアウト (現在のレイアウトのコピー)、レイアウト名を変更、レイアウトを削除 があります。最後のレイアウトは削除できず、名前は一意である必要があります。
レイアウトと試していたステップは、構成とは別に、このコンピューターのあなたの Windows アカウント用に保存されます。エクスポートされることはなく、構成ファイルにも含まれません。
実行する内容
実行する内容 タブには、アクションと同じステップ エディターがあります (ステップ エディター)。
詳細モード。 エディターの上の ステップ / スクリプト の切り替えで、代わりにスクリプトを試せます。ステップがある状態でスクリプトに切り替えると、アクション ページと同様に変換が提案されます。シンプル モードに戻ると、ページは再びステップを表示します。スクリプトは保持されます。
実行前
仮のデスクトップには、独自のクリップボードと独自のメッセージ ボックスがあります。実行前 タブでそれらを設定します。デスクトップの下の行に両方の概要が表示され、クリックするとこのタブが開きます。
- クリップボード: 実行の開始時にクリップボードに入っているテキスト (最大 256 文字)。空のクリップボードで始めるには空のままにします。実際のクリップボードが読み取られたり変更されたりすることはありません。
- メッセージ ボックスへの応答: 実行で表示されるメッセージ ボックスごとに 1 行 (ボックス 1、ボックス 2 など)、最大 16 行です。各ボックスは一覧の次の応答を受け取ります。その応答がボックスのボタンにない場合や、一覧を使い切った場合は、ボックスの最初のボタンが押されます。
実行と再生
実行 ① をクリックします。ステップがエンジンに送られ、エンジンはレイアウトに対してそれを実行し、起こったことをすべて返します。その後、ページはそれをデスクトップ上で再生します。
- 各ステップは独自の区切りとして再生され、一覧でそのステップが強調表示されます。待機は実行自体の時間で再生されます。
- 再生 / 一時停止、1 つ進む (次の区切りへ)、もう一度再生、0.5×～4× の 速度、レイアウトに戻る があります。レイアウトやステップを変更しても再生は終わります。
- 再生中は、デスクトップの下の行に、その時点でクリップボードに入っているものが表示されます。実行で表示されたメッセージ ボックスは、押されたボタンが点灯した状態でメイン画面に描かれます。
- ステップがログに書き込んだものは、出力されたテキスト の下に表示されます。
- 最後に、ページに 実行が完了しました。 と表示されるか、どのステップがなぜ失敗したかが表示されます。スクリプトでは、代わりに行が示されます。
実行は、次の場合にメッセージと共に早めに停止します。
- ファイル、ほかのプログラム、プラグイン、スニペット、電源やサインアウトの組み込み関数など、サンドボックスの外に及ぶ組み込み関数を使った場合 (サンドボックスでは使用できません)。
- 200,000 を超える命令を実行した場合、2,000 を超えるイベントを記録した場合、または実行自体の時間で 10 分に達した場合 (たとえば終わらないループ)。
- 8,000 文字を超える場合 (まったく実行されません)。
コンパイル エラーや、エンジンからの応答がない場合は、再生なしで表示されます。
サンドボックスがシミュレートしないもの
サンドボックスは見せかけにすぎず、実際のプログラムは異なる動作をすることがあります。
- フォーカスの規則、ウィンドウ内のコントロール、管理者として実行されるプログラムはシミュレートされません。
- 代役には選択範囲がないため、コピーのキーの組み合わせでは何もコピーされません。入力と貼り付けでは、アクティブな代役にテキストが追加されます。
- 最小化された代役は、Windows が最小化されたウィンドウに与える位置を報告します。
- 仮の画面のデバイス パスは作り物なので、実際のモニターのデバイス パスを指定するステップは何も見つけません。フレンドリ名は一致します。
ステップを持ち出す
- ステップをコピー (スクリプトでは スクリプトをコピー) は、実行する内容をクリップボードにコピーします。
- スニペットとして保存 は、それからスニペットをステップまたはスクリプトとして作成し、スニペット ページで開きます (スニペット)。そこから、アクションがそれを呼び出したり、ステップをアクションにコピーしたりできます。