GroupActivate

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

HWND := GroupActivate(GroupName , Mode)

パラメータ

GroupName

型:文字列

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

Mode

型:文字列

If blank or omitted, the function activates the oldest window in the series. Otherwise, specify the following letter:

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

戻り値

型:整数

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

備考

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

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

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

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

GroupAdd, GroupDeactivate, GroupClose, #WinActivateForce

ウィンドウグループ内で最も新しいウィンドウ(最近アクティブになったウィンドウ)をアクティブにします。

GroupActivate "MyGroup", "R"