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