GroupActivate

GroupAdd関数で定義したウィンドウグループの中の次のウィンドウをアクティブにします。

HWND := GroupActivate(GroupName , Mode)

パラメータ

GroupName

型：文字列

GroupAddで定義された、アクティブ化するグループの名前。

Mode

型：文字列

空白または省略すると、この関数は最も古いウィンドウをアクティブにします。そうでなければ、次の文字を指定します：

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

戻り値

型：整数

この関数は、アクティブ化するために選択されたウィンドウのHWND（ユニークID）を返し、アクティブ化するために一致するウィンドウが見つからなかった場合は0を返します。現在のアクティブなウィンドウが唯一の一致である場合、戻り値は 0 です。

備考

グループのウィンドウ指定に合致する最初のウィンドウをアクティブにする機能です。2回目に使用すると、シリーズの次のウィンドウが起動します。通常は、ホットキーに割り当てられており、そのキーを押すことでこのウィンドウ遷移の動作が自動化されるようになっています。

各ウィンドウは、ウィンドウの仕様を区別することなく、ウィンドウグループ全体に対して評価されます。モードは、グループ全体の起動順序に影響します。

他のウィンドウをアクティブにした直後にウィンドウをアクティブにすると、システムによってはタスクバーのボタンが点滅し始めることがあります（OSや設定によって異なります）。これを防ぐために、#WinActivateForceを使ってください。

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

関連

GroupAdd、GroupDeactivate、GroupClose、#WinActivateForce

例

GroupActivate "MyGroup", "R"