# MenuSelect

从指定窗口菜单栏中调用菜单项.

    MenuSelect WinTitle, WinText, Menu , SubMenu1, SubMenu2, SubMenu3, SubMenu4, SubMenu5, SubMenu6, ExcludeTitle, ExcludeText

## 参数

WinTitle, WinText, ExcludeTitle, ExcludeText

  类型: 字符串, 整数或对象

  如果这些都未设置或省略, 将使用上次找到的窗口. 否则, 为 WinTitle 指定窗口标题或其他条件, 来标识目标窗口, 和/或为 WinText 指定目标窗口的单个文本元素的子字符串(由包含的 Window Spy 实用程序显示). 如果 DetectHiddenText 已经打开, 则检测隐藏文本元素. 标题或文本包含 ExcludeTitle 或 ExcludeText 的窗口将不被考虑.

Menu

  类型: 字符串

  顶级菜单项的名称(或名称前缀), 例如 File, Edit, View. 此参数也可以使用期望的菜单项的位置, 通过使用 `1&` 表示首个菜单, `2&` 表示第二个, 以此类推.

  根据当前用户区域设置的规则, 搜索是不区分大小写的, 并在第一个匹配项处停止. 使用和符号(&) 来表示菜单项中带下划线的字母, 通常 是不必要的(例如 &File 等同于 File).

  已知限制: 如果参数包含一个和符号(&), 那么它必须与项目名称完全匹配, 包括所有非原义的和符号(隐藏或显示为下划线). 如果参数不包含和符号, 则忽略所有和符号, 包括原义的. 例如, 显示为 "a & b" 的项可能匹配的参数值为 `a && b` 或 `a b`.

  指定 `0&` 使用窗口的系统菜单.

SubMenu1

  类型: 字符串

  要选择的菜单项的名称或位置(请参阅上面).

  如果顶级项目不包含菜单(罕见的), 则可以省略此项.

SubMenu2

  类型: 字符串

  如果 SubMenu1 包含子菜单, 那么这是子菜单项的名称或位置.

SubMenu3
SubMenu4
SubMenu5
SubMenu6

  类型: 字符串

  同上.

## 错误处理

如果找不到窗口或控件, 则抛出 TargetError.

如果找不到菜单, 子菜单或菜单项, 或最后的菜单参数对应于一个打开子菜单的菜单项, 则抛出 ValueError.

## 备注

为了使该函数工作, 目标窗口可以处于不活动状态. 然而, 某些窗口可能需要处于非最小化状态.

函数对于使用非标准菜单栏的应用程序 无效. 例如 Microsoft Outlook 和 Outlook Express, 它们使用伪装的工具栏作为菜单栏. 在这种情况下, 考虑使用 ControlSend 或 PostMessage, 它们应该能和一些这样的非标准菜单栏交互.

参数中的菜单名称还可以使用位置代替. 提供这种方法是为了支持不包含文本的菜单(可能是由于它们包含文本的图片而不是真实的文本). 位置 1& 表示首个菜单项(例如 File 菜单), 位置 2& 表示第二个菜单项(例如 Edit 菜单), 以此类推. 为了确定菜单项的位置, 菜单分隔线也作为菜单项计算.

窗口标题和文本是区分大小写的. 除非 DetectHiddenWindows 被打开, 否则不会检测隐藏窗口.

## 系统菜单

Menu 可以是 `0&`, 以选择窗口系统菜单的项目, 该菜单通常在用户按下 `Alt`+`Space` 或点击窗口标题栏中的图标时出现. 例如:

    ; 粘贴命令到 cmd.exe 而不用激活窗口.
    A_Clipboard := "echo Hello, world!`r"
    MenuSelect "ahk_exe cmd.exe",, "0&", "Edit", "Paste"

警告: 仅在窗口的系统菜单中具有自定义项目时使用此项.

如果窗口还没有自定义系统菜单, 则将产生创建一个标准系统菜单的副本并关联到目标窗口的副作用. 该副本在脚本退出时被系统销毁, 导致其他脚本无法访问该副本. 因此, 避免在所有显示标准项目的窗口上使用 0& 作为代替, 直接 post WM_SYSCOMMAND 消息. 例如:

    ; 类似 [WinMinimize "A"], 但最小化时播放系统声音.
    WM_SYSCOMMAND := 0x112
    SC_MINIMIZE := 0xF020
    PostMessage WM_SYSCOMMAND, SC_MINIMIZE, 0,, "A"

## 相关

ControlSend, PostMessage

## 示例

选择记事本的 `File -> Open` 菜单. 这个例子在 Windows 11 或更高版本系统可能会失败, 因为它需要经典版本的记事本.

    MenuSelect "Untitled - Notepad",, "File", "Open"

与上述相同, 只是按位置而不是按名称进行. 在 Windows 10 中, 2& 必须被替换为 3&, 因为新的 "New Window" 菜单项. 这个例子在 Windows 11 或更高版本系统可能会失败, 因为它需要经典版本的记事本.

    MenuSelect "Untitled - Notepad",, "1&", "2&"

选择主窗口中的 `View -> Lines most recently executed`.

    WinShow "ahk_class AutoHotkey"
    MenuSelect "ahk_class AutoHotkey",, "View", "Lines most recently executed"

dftg