# #ClipboardTimeout

改变当首次访问剪贴板失败后脚本继续尝试访问剪贴板的持续时间.

    #ClipboardTimeout Milliseconds

## 参数

Milliseconds

  间隔长度, 单位为毫秒. 指定 -1 表示持续访问剪贴板. 指定 0 表示只访问一次. 没有使用此指令的脚本使用 1000 ms 的超时时间.

## 备注

一些应用程序让剪贴板长时间保持打开, 可能是要读写大量数据. 此时, 增加此设置的值可以让脚本在放弃并显示错误信息前等待较长的时间.

此设置适用于所有的剪贴板操作, 这里举些最简单的例子: `Var := Clipboard` 和 `Clipboard := "New Text"`.

每当脚本处于等待剪贴板变得可用的状态时, 不能 运行新的线程且不会运行计时器. 但是, 如果用户按下了热键, 选择了自定义菜单项或执行例如按下按钮这样的 GUI 动作, 这些事件会被缓存至后面; 换句话说, 其子程序会在剪贴板变得可用后执行.

如果第一次读取剪切板失败, 此指令不会导致重新尝试读取剪贴板数据. 在 [v1.1.16] 前, 它确实会使脚本等待直至超时, 但这样做会阻止检索任何进一步的数据.

和其他指令一样, #ClipboardTimeout 不能有条件地执行.

## 相关

Clipboard, Thread

## 示例

使脚本在放弃访问剪贴板并显示错误信息之前, 等待 2 秒而不是 1 秒.

    #ClipboardTimeout 2000

dftg