GroupClose

GroupActivate関数またはGroupDeactivate関数によってアクティブになったウィンドウを閉じます。そして、シリーズの次のウィンドウをアクティブにします。また、グループ内のすべてのウィンドウを閉じることも可能です。

GroupClose GroupName , Mode

パラメータ

GroupName

型：文字列

GroupAddで元々定義されているグループ名。

Mode

型：文字列

空白または省略したときは、アクティブウィンドウを閉じて、グループの中で最も古いウィンドウをアクティブにします。そうでなければ、次の文字のうち、ひとつを指定してください：

R：最も新しいウィンドウ（直近でアクティブになったウィンドウ）をアクティブにします。ただし、この関数が与えられたときにグループのどのメンバーもアクティブになっていないときだけです。"R"は、一時的に関係ない作業に切り替えるケースに有効です。GroupActivate、GroupDeactivate、GroupCloseでグループに戻ると、最も古いウィンドウではなく、直近で操作していたウィンドウがアクティブになります。

A：グループの全メンバーがクローズとなります。WinClose "ahk_group GroupName"と同じ効果です。

備考

Modeパラメータが "A"でない場合、GroupNameに対する直前のアクションがGroupActivateかGroupDeactivateかによって、この関数の動作が決定されます。GroupDeactivateの場合、アクティブなウィンドウがグループのメンバーでない場合のみ閉じます（それ以外は何もしません）。GroupActivateであった場合、または何もしなかった場合、この関数はアクティブなウィンドウがグループのメンバーである場合にのみ閉じます（そうでない場合は何もしません）。この動作により、GroupNameのGroupActivateまたはGroupDeactivateのホットキーに付随するものとして、GroupCloseをホットキーに割り当てることができます。

アクティブなウィンドウが閉じると、システムは通常、次に最も新しくアクティブになったウィンドウをアクティブにします。新しくアクティブになったウィンドウが、直前に閉じたウィンドウと同じウィンドウ仕様にマッチする場合、デフォルトのモードでは 最も古いウィンドウを次にアクティブにするように指示されているにもかかわらず、そのウィンドウはアクティブのままです。新しくアクティブになったウィンドウが、グループのウィンドウ指定のいずれかと一致する場合、そのウィンドウはアクティブのままになります。

ウィンドウグループの詳細については、GroupAddをご覧ください。

関連

GroupAdd、GroupActivate、GroupDeactivate

例

GroupClose "MyGroup", "R"