发送模拟键盘输入到窗口或控件.
ControlSend Keys , Control, WinTitle, WinText, ExcludeTitle, ExcludeText ControlSendText Keys , Control, WinTitle, WinText, ExcludeTitle, ExcludeText
类型: 字符串
要发送的按键的序列(有关详情, 请参阅 Send 函数). 发送字符的速率由 SetKeyDelay 决定.
与 Send 函数不同, ControlSend 不能发送鼠标点击. 请使用 ControlClick 来发送.
Hwnd 属性的对象. 有关详情, 请参阅 Control 参数.
如果省略此参数, 击键将直接发送到目标窗口, 而不是它的一个控件(有关示例, 请参阅 Automating Winamp).
识别目标窗口的窗口标题或其他条件. 请参阅 WinTitle.
类型: 字符串
如果存在, 此参数必须是目标窗口的单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 如果 DetectHiddenText 为 ON, 那么会检测隐藏文本元素.
类型: 字符串
标题中含有此参数值的窗口将被排除.
类型: 字符串
文本中含有此参数值的窗口将被排除.
如果找不到窗口或控件, 则抛出 TargetError.
ControlSendText 发送 Keys 参数中的单个字符, 不将 {Enter} 转换为 Enter, ^c 转换为 Ctrl+C, 等等. 有关详情, 请参阅 Text 模式. 也可以在 ControlSend 中使用 {Raw} 或 {Text}.
如果省略 Control 参数, 该函数将尝试直接发送至目标窗口的最上面的控件(通常是正确的控件), 如果没有控件, 则发送至窗口本身. 如果一个窗口看起来根本没有任何控件, 或者只是为了方便且不必担心发送到哪个控件, 那么这个函数就很有用.
默认情况下, 修饰键(Ctrl, Alt, Shift 和 Win) 会像正常情况下一样由 Send 函数发送. 这使得命令提示符和其他控制台窗口能够正确检测大写字母, 控制字符等. 它还可以在其他方面提高可靠性.
然而, 在某些情况下, 这些修饰符事件可能会干扰活动窗口, 特别是当用户在 ControlSend 期间正在进行输入, 或者正在发送 Alt 键时(因为 Alt 会激活活动窗口的菜单栏). 可以通过显式发送修饰符按下和弹起事件来避免这种情况, 如本例所示:
ControlSend "{Alt down}f{Alt up}", "Edit1", "Untitled - Notepad"
上面的方法也允许在工作站被锁定(由登录提示保护) 时发送修饰键(Ctrl, Alt, Shift 和 Win).
当在命令提示符等控制台窗口中使用 ControlSend 时, 应避免使用 BlockInput. 这是因为它可能会阻止大写和修饰键(如 Ctrl) 的正常工作.
SetKeyDelay 的值决定了按键的发送速度. 如果目标窗口无法可靠地接收按键, 请尝试通过 SetKeyDelay 的第二个参数来增加按下的持续时间, 如下面的例子所示:
SetKeyDelay 10, 10 SetKeyDelay 0, 10 SetKeyDelay -1, 0
如果目标控件是一个 Edit 控件(或类似的控件), 下面的方法通常比 ControlSend 更可靠和更快:
EditPaste("This text will be inserted at the caret position.", ControlName, WinTitle)
ControlSetText("This text will entirely replace any current text.", ControlName, WinTitle)
ControlSend 通常不能操纵窗口的菜单栏. 要解决这个问题, 可以使用 MenuSelect. 如果由于菜单栏的性质而无法做到这一点, 你可以尝试按照 SendMessage 教程来发现对应于所需菜单项的消息.
窗口标题和文本是区分大小写的. 除非 DetectHiddenWindows 被打开, 否则不会检测隐藏窗口.
SetKeyDelay, 转义序列(例如 `n) , Control 函数, Send, 自动化 Winamp
Run "Notepad",, "Min", &PID ; 最小化运行记事本.
WinWait "ahk_pid " PID ; 等待记事本进程的出现.
; 将文本发送到不活动的记事本编辑控件.
; 省略了第三个参数, 因此使用最后一个找到的窗口.
ControlSend "This is a line of text in the notepad window.{Enter}", "Edit1"
ControlSendText "Notice that {Enter} is not sent as an Enter keystroke with ControlSendText.", "Edit1"
Msgbox "Press OK to activate the window to see the result."
WinActivate "ahk_pid " PID ; 显示结果.