창 그룹에 창 규격을 추가합니다. 필요하면 그룹을 생성합니다.
GroupAdd, GroupName [, WinTitle, WinText, Label, ExcludeTitle, ExcludeText]
이 창 규격에 추가할 그룹의 이름. 그룹이 존재하지 않으면, 생성됩니다. 그룹 이름은 대소문자를 가리지 않습니다.
목표 창을 식별할 창 제목 또는 기타 기준. WinTitle 참조.
존재하면, 이 매개변수는 목표 창 텍스트의 부문자열입니다 (Window Spy에 노출됨). 숨은 텍스트는 GroupActivate, GroupDeactivate, and GroupClose가 사용되는 순간에 DetectHiddenText가 켜져 있어야(ON) 탐지됩니다.
GroupActivate명령어가 사용될 때 이 그룹에 부합하는 창이 존재하지 않으면 실행할 서브루틴의 라벨 (또는 AHK_L 54 이전이면 다음 창 규격). 마치 Gosub가 사용된 것처럼 라벨로 점프합니다. 아무것도 없으면 생략하거나 비워 둡니다.
제목에 이 값이 있는 창은 무시합니다.
텍스트에 이 값이 있는 창은 무시합니다.
이 명령어를 사용할 때마다 새로운 규칙이 그룹에 추가됩니다. 다른 말로 하면, 그룹은 고정된 창 목록이 아니라 기준 집합으로 구성됩니다. 나중에, 그룹을 GroupActivate와 같은 명령어가 사용할 때, 바탕화면 위의 각 창은 이 기준에 맞는지 점검됩니다. 창이 그룹의 기준 중 하나에 부합하면, 부합한 것으로 간주됩니다.
SetTitleMatchMode와 DetectHiddenWindows는 이 명령어의 행위에 직접적으로 영향을 주지는 않지만, GroupActivate와 GroupClose 같은 다른 그룹 명령어에는 영향을 미칩니다. 또 ahk_group을 다른 명령어의 WinTitle에 사용할 때에도 영향을 미칩니다.
창 그룹은 전형적으로 관련 창 집단을 함께 묶는데 사용됩니다. 많은 창이 관련되는 작업에 또는 많은 하위 창을 소유한 어플리케이션에 유용합니다. 예를 들어, 그래픽 프로그램이나 텍스트 편집기의 많은 실체와 자주 작업한다면, GroupActivate를 핫키에 사용해서 그 프로그램의 각 실체를 한 번에 하나씩 방문할 수 있습니다. 창을 찾으려고 알트-탭을 누르거나 태스크 바 버튼을 누를 필요가 없습니다.
각 그룹의 엔트리는 한 번만 추가하면 되기 때문에, 이 명령어는 전형적으로 (스크립트의 상단 부분) 자동 실행 섹션에 사용됩니다. 중복 엔트리를 그룹에 추가하려고 시도하면 무시됩니다.
그룹에 모든 창을 포함하려면 (특별한 프로그램 관리자 창 제외), 다음 예제를 사용하십시오:
GroupAdd, AllWindows
모든 창 명령어는 창 그룹에 작용할 수 있습니다. ahk_group MyGroupName을 WinTitle 매개변수에 지정하면 됩니다. 명령어 WinMinimize, WinMaximize, WinRestore, WinHide, WinShow, WinClose, 그리고 WinKill은 그룹의 모든 창에 작용할 것입니다. 대신에 최상단 창에만 작용시키고 싶으면, 다음 예제를 따르십시오:
WinHide % "ahk_id " . WinExist("ahk_group MyGroup")
대조적으로, WinActivate와 IfWinExist와 같은 다른 창 명령어는 그룹의 최상위 창에만 작동합니다.
GroupActivate, GroupDeactivate, GroupClose
; 스크립트의 상단 자동 실행 섹션에서: GroupAdd, MSIE, ahk_class IEFrame ; 이 그룹에 Internet Explorer 창만 추가합니다. return ; 자동 실행 섹션의 끝. ; 이 그룹을 활성화 할 핫키를 할당합니다. 열린 모든 ; MSIE 창을, 한 번에 하나 씩, 순회합니다 ; (즉, 핫키를 누를 때마다). Numpad1::GroupActivate, MSIE, r ; 다음은 MS Outlook 2002에 대한 좀 복잡한 그룹입니다. ; 스크립트의 상단 자동 실행 섹션에서: SetTitleMatchMode, 2 GroupAdd, mail, Message - Microsoft Word ; 현재 작성 중인 메일을 위한 것입니다 GroupAdd, mail, - Message ( ; 이미 열린 항목들을 위한 것입니다 ; 유령 창이 활성화되는 것을 피하려면 추가 텍스트가 필요합니다: GroupAdd, mail, Advanced Find, Sear&ch for the word(s) GroupAdd, mail, , Recurrence: GroupAdd, mail, Reminder GroupAdd, mail, - Microsoft Outlook return ; 자동 실행 섹션의 끝. Numpad5::GroupActivate, mail ; 각 아웃룩 창을, 한 번에 하나 씩 방문할, 핫키를 할당합니다.