# #ClipboardTimeout

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

    #ClipboardTimeout Milliseconds

## 参数

Milliseconds

  类型: 整数

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

## 备注

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

此设置适用于所有的剪贴板操作, 最简单的例子如下: `Var := A_Clipboard` 和 `A_Clipboard := "New Text"`.

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

如果第一次尝试失败, 此指令 不会 导致重新尝试读取剪贴板数据.

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

## 相关

A_Clipboard, Thread

## 示例

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

    #ClipboardTimeout 2000

dftg