# ControlSetText

改变控件的文本.

ControlSetText [, Control, NewText, WinTitle, WinText, ExcludeTitle, ExcludeText]

#### 参数

Control | 可以是 ClassNN (控件的类名和实例号) 或控件的名称/文本, 他们都可以通过 Window Spy 来确定. 当使用名称/文本时, 匹配模式由 SetTitleMatchMode 决定. 如果此参数为空, 将使用目标窗口的顶层控件. 要对一个控件的 HWND (窗口句柄) 进行操作, 请将 Control 参数留空同时在 WinTitle 参数中指定 ahk_id %ControlHwnd% (即使 DetectHiddenWindows 是关闭的, 这样也适用于隐藏的控件) . 获取控件的 HWND 的典型方法是使用 ControlGet Hwnd, MouseGetPos, 或 DllCall 命令.
NewText | 给控件设置的新文本. 如果为空或省略, 控件将被置空
WinTitle | 目标窗口的标题或标题中的部分文字 (匹配模式由 SetTitleMatchMode 决定).如果此参数和后面三个参数都忽略, 默认目标是 上一次匹配窗口. 如果此参数是字母 A, 同时省略后面三个参数, 则以当前的活动窗口为目标. 要用窗口的类名进行匹配, 请指定 ahk_class ExactClassName (Window Spy 中可以显示类名).要用窗口的 进程标识符 (PID) 进行匹配, 请指定 ahk_pid %PID变量%.要使用 窗口组 进行匹配, 请指定 ahk_group GroupName.要使用窗口的 唯一 ID 进行匹配, 请指定 ahk_id %VarContainingID%.要减小检测范围, 请指定 多重条件.例如: My File.txt ahk_class Notepad
WinText | 如果使用这个参数, 则它应该是目标窗口中某个文本元素的子字符串 (在 Window Spy 中会显示窗口中的文本元素).隐藏文本只有当 DetectHiddenText 设置为 ON 的时候才能检测到.
ExcludeTitle | 标题中包含该参数指定的文字的窗口将被排除.
ExcludeText | 文本元素中包含该参数指定的文字的窗口将被排除.

#### ErrorLevel

如果出现错误, ErrorLevel 被设置为 1, 否则为 0.

#### 备注

大部分控件类型使用回车和换行 (`r`n) 而不是一个单独的换行 (`n) 来表示每一行的结束. 要转换包含 `n 字符的文本块, 请参照这个例子: StringReplace, MyVar, MyVar, `n, `r`n, All

为了提高可靠性, 在每次使用此命令后都自动地有一个延迟.这个延迟可以通过 SetControlDelay 改变.

窗口中的标题和文字是大小写敏感的.要检测隐藏窗口, 必须打开 DetectHiddenWindows.

#### 相关

SetControlDelay, ControlGetText, ControlGet, Control, ControlMove, ControlGetPos, ControlClick, ControlFocus, ControlSend

#### 示例

    ControlSetText, Edit1, New Text Here, Untitled -