# ClipWait

等到剪贴板包含数据。

ClipWait [, SecondsToWait, 1]

#### 参数

SecondsToWait | 如果省略，此命令会无限地等待。否则，它将等待不超过这么多秒 (可包含小数点或者是一个表达式)。指定为 0 则等同于 0.5。
1 | 如果此参数被省略，命令将更有选择性，明确地等待文本或文件的出现(“文本”包括任何在你粘贴进记事本时会产生文本的东西)。如果此参数为 1 (可以是一个表达式)，命令等待任何类型的数据出现在剪贴板。

#### ErrorLevel

如果等待时间到期，ErrorLevel 会被设置成 1。否则(例如剪贴板包含数据)，ErrorLevel 设置成 0。

#### 说明

使用此命令比一个你自己用来检查剪贴板是否为空的循环要好。这是因为剪贴板从未被此命令打开，因此它执行地更好并且避免了对可能使用剪贴板的其他应用程序的干扰。

此命令把任何可转换成文本的东西(例如 HTML)视为文本。它也把文件视为文本，例如那些在资源管理器窗口通过 Control-C 复制的文件。每当剪贴板变量(%clipboard%)在脚本中被使用，这样的文件就被自动地转换为它们的文件名(以绝对路径)。详见剪贴板。

最后的参数是 1 时，任何数据出现在剪贴板上命令都将满意。它能和 ClipboardAll 一起用来保存非文本数据，例如图片。

当命令处于等待状态，新的线程能通过 热键、自定义菜单项或者定时器被运行。

#### 相关命令

Clipboard, WinWait, KeyWait

#### 范例

    clipboard = ;清空剪贴板
    Send, ^c
    ClipWait, 2
    if ErrorLevel
    {
        MsgBox, 尝试复制文本到剪贴板失败。
        return
    }
    MsgBox, clipboard = %clipboard%
    return

翻译：天堂之门 menk33@163.com 2008年11月6日