クリップボードへのアクセスに失敗したときに、スクリプトが試行し続ける時間を変更します。
#ClipboardTimeout Milliseconds
型:整数
インターバルの長さをミリ秒単位で指定します。無限に試行し続ける場合は-1を指定します。0を指定すると、1回だけ試行します。
このディレクティブが指定されないときは、1000(ミリ秒)が設定されたものとして動作します。
アプリケーションによっては、大量のデータを書き込んだり読み込んだりするために、クリップボードを長時間開いたままにしておくことがあります。そのような場合、この設定を増やすと、スクリプトはより長く待機して、諦めてエラーメッセージを表示するようになります。
この設定は、すべてのクリップボード操作に適用されます。最も簡単な例は次のとおりです:Var := A_Clipboard
、A_Clipboard := "New Text"
。
クリップボードが使用可能になるのをスクリプトが待っている間は常に、新しいスレッドを起動できず、タイマーも実行されません。しかし、ユーザーがホットキーを押したり、カスタムメニューを選択したり、ボタンを押すなどのGUIアクションを行った場合、そのイベントは後までバッファされます。言い換えれば、そのサブルーチンはクリップボードが最終的に利用可能になった後に実行されます。
このディレクティブは、最初の試行が失敗したときはクリップボードデータの読み取りを再試行しません。
他のディレクティブと同様に、#ClipboardTimeoutは条件付きで実行することはできません。