# StatusBarGetText

获取标准的状态栏控件中的文本.

StatusBarGetText, OutputVar [, Part#, WinTitle, WinText, ExcludeTitle, ExcludeText]

#### 参数

OutputVar | 用于保存获取的文本的变量名称.
Part# | 希望获取文本的状态栏那一部分的数字, 可以是一个 表达式. 默认值为 1, 这部分通常包含了我们感兴趣的文本.
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. 如果出现了错误, OutputVar 会被置空.

#### 备注

该命令尝试读取一个窗口中第一个 标准 状态栏 (Microsoft 通用控件: msctls_statusbar32).? 某些程序使用它们自己的状态栏控件或者 MS 通用控件的特殊版本, 这样的情况下无法获取它的文本.

通常情况下使用 StatusBarWait 命令比在一个循环中使用该命令更有效率, 因为它包含了避免重复调用 StatusBarGetText 形成的高开销的优化.

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

#### 相关

StatusBarWait, WinGetTitle, WinGetText, ControlGetText

#### 示例

    StatusBarGetText, RetrievedText, 1, Search Results
    IfInString, RetrievedText, found, MsgBox, Search results have been found.