Fügt eine Fensterspezifikation zu einer Fenstergruppe hinzu, und erstellt die Gruppe, falls erforderlich.
GroupAdd, GruppeName , FensterTitel, FensterText, Label, AusnahmeTitel, AusnahmeText
Name der Gruppe, zu der diese Fensterspezifikation hinzugefügt werden soll. Wenn die Gruppe nicht existiert, wird sie erstellt. Gruppennamen sind nicht Groß-/Kleinschreibung-sensitiv.
Geben Sie für FensterTitel einen Fenstertitel oder andere Kriterien zur Identifizierung des Zielfensters und/oder für FensterText eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden). Versteckte Textelemente werden erkannt, wenn DetectHiddenText zum Zeitpunkt der Verwendung von GroupActivate, GroupDeactivate und GroupClose eingeschaltet wurde. Fenster, deren Titel oder Texte AusnahmeTitel bzw. AusnahmeText enthalten, werden ignoriert.
Wenn leer oder weggelassen, wird kein Label verwendet. Andernfalls geben Sie das Label einer Subroutine an, die ausgeführt werden soll, wenn bei Verwendung des GroupActivate-Befehls keine Fenster gefunden werden, die dieser Gruppe (oder dieser Fensterspezifikation vor AHK_L 54) entsprechen. Es wird zum Label gesprungen, als hätte man Gosub verwendet.
Jedes Mal, wenn Sie diesen Befehl verwenden, wird eine neue Regel zur Gruppe hinzugefügt. Mit anderen Worten, eine Gruppe besteht aus einer Reihe von Kriterien, nicht aus einer festen Liste von Fenstern. Wenn Sie später mit Befehlen wie GroupActivate eine Gruppe verwenden, wird jedes Fenster auf dem Desktop mit den Kriterien verglichen. Stimmt ein Fenster mit einem der Kriterien aus der Gruppe überein, gilt das Fenster als gefunden.
Obwohl SetTitleMatchMode und DetectHiddenWindows das Verhalten dieses Befehls nicht direkt beeinflussen können, beeinflussen sie andere Gruppenbefehle wie GroupActivate und GroupClose. Diese haben auch Einfluss auf die Verwendung von ahk_group im FensterTitel-Parameter eines anderen Befehls.
Eine Fenstergruppe wird üblicherweise verwendet, um mehrere zusammenhängende Fenster zu vereinen, die zu einer Aufgabe gehören oder untergeordnete Fenster einer Anwendung sind. Wenn Sie z.B. häufig mit vielen Instanzen eines Grafikprogramms oder eines Texteditors arbeiten, können Sie einen Hotkey mit GroupActivate verwenden, um alle Instanzen dieses Programms nacheinander durchzugehen, ohne dass Alt-Tab-Aktionen oder Taskleistenschaltflächen zum Auffinden einer Instanz notwendig sind.
Da die Einträge in jeder Gruppe nur einmal hinzugefügt werden müssen, wird dieser Befehl üblicherweise im automatischen Ausführungsbereich (ganz oben im Skript) verwendet. Jegliche Versuche, doppelte Einträge zu einer Gruppe hinzuzufügen, werden ignoriert.
Um alle Fenster zu einer Gruppe hinzuzufügen (außer dem speziellen Programm-Manager-Fenster), verwenden Sie folgendes:
GroupAdd, AllWindows
Alle fensterspezifischen Befehle ermöglichen die Nutzung einer Fenstergruppe durch die Angabe von ahk_group MeineGruppeName im FensterTitel-Parameter. Die Befehle WinMinimize, WinMaximize, WinRestore, WinHide, WinShow, WinClose und WinKill beeinflussen alle Fenster der Gruppe. Um stattdessen nur das oberste Fenster zu beeinflussen, gehen Sie wie folgt vor:
WinHide % "ahk_id " . WinExist("ahk_group MeineGruppe")
Andere Fensterbefehle wie WinActivate, WinExist() und IfWinExist beeinflussen hingegen nur das oberste Fenster einer Gruppe.
GroupActivate, GroupDeactivate, GroupClose
Drücken Sie einen Hotkey, um alle geöffneten MSIE-Fenster durchzugehen.
; Im automatischen Ausführungsbereich am Anfang des Skripts: GroupAdd, MSIE, ahk_class IEFrame ; Fügt nur Internet-Explorer-Fenster zur Gruppe hinzu. return ; Ende des automatischen Ausführungsbereichs. ; Weist einen Hotkey zum Aktivieren dieser Gruppe hinzu, ; der alle offenen MSIE-Fenster nacheinander durchgeht ; (also jedes Mal, wenn der Hotkey gedrückt wird). Numpad1::GroupActivate, MSIE, r
Drücken Sie einen Hotkey, um alle MS-Outlook-2002-Fenster nacheinander durchzugehen.
; Im automatischen Ausführungsbereich am Anfang des Skripts: SetTitleMatchMode, 2 GroupAdd, mail, Nachricht - Microsoft Word ; Für E-Mails, die gerade entworfen werden GroupAdd, mail, - Nachricht ( ; Für bereits geöffnete E-Mails ; Benötigt zusätzlichen Text, um die Aktivierung eines Phantomfensters zu verhindern: GroupAdd, mail, Erweiterte Suche, Dur&chsuchen... GroupAdd, mail, , Recurrence: GroupAdd, mail, Erinnerungsfenster GroupAdd, mail, - Microsoft Outlook return ; Ende des automatischen Ausführungsbereichs. ; Weist einen Hotkey zu, um jedes Outlook-Fenster nacheinander zu besuchen. Numpad5::GroupActivate, mail