# GroupActivate

激活由 GroupAdd 定义的窗口组中的下一个窗口.

    HWND := GroupActivate(GroupName , Mode)

## 参数

GroupName

  类型: 字符串

  要激活的组的名称, 和原来由 GroupAdd 定义的一样.

Mode

  类型: 字符串

  如果未设置或省略, 激活组中最早的窗口. 否则, 请指定以下字母:

  R: 最新的窗口(最近激活的窗口) 被激活, 但仅当函数运行时组中没有活动的成员时才会激活. "R" 在临时切换到处理不相关任务的情况下非常有用. 当您使用 GroupActivate, GroupDeactivate 或 GroupClose 返回到目标组时, 会激活您最近工作的窗口而不是最早的窗口.

## 返回值

类型: 整数

该函数返回所选窗口的HWND(唯一 ID), 如果没有找到匹配的窗口进行激活, 则返回 0. 如果当前激活的窗口是唯一匹配的窗口, 则返回值为 0.

## 备注

此函数使匹配组窗口规格之一的第一个窗口被激活. 再次使用它将激活系列中的下一个窗口, 依此类推. 通常, 将其分配给一个热键, 以便通过按下该热键自动遍历窗口.

每个窗口都是根据窗口组作为一个整体来评估的, 而不区分窗口规格. Mode 影响整个组的激活顺序.

在激活另一个窗口后立即激活一个窗口时, 任务栏按钮可能在某些系统上可能会闪烁(取决于操作系统和设置). 为防止这种情况, 请使用 #WinActivateForce.

关于窗口组的更多细节, 请参阅 GroupAdd.

## 相关

GroupAdd, GroupDeactivate, GroupClose, #WinActivateForce

## 示例

激活窗口组中最新的窗口(最近活动的窗口).

    GroupActivate "MyGroup", "R"

dftg