Fügt eine Fensterspezifikation zu einer Fenstergruppe hinzu, und erstellt die Gruppe, falls erforderlich.
GroupAdd GruppeName , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText
Typ: Zeichenkette
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.
Typ: Zeichenkette, Integer oder Objekt
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).
AusnahmeTitel und AusnahmeText können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von FensterTitel und FensterText, außer dass AusnahmeTitel keine anderen Kriterien als den Fenstertitel erkennt.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Obwohl DetectHiddenWindows, DetectHiddenText und SetTitleMatchMode das Verhalten dieser Funktion nicht direkt beeinflussen, beeinflussen sie die anderen Gruppenfunktionen wie GroupActivate und GroupClose. Diese haben auch Einfluss auf die Verwendung von ahk_group im FensterTitel-Parameter einer anderen Funktion.
Jedes Mal, wenn Sie diese Funktion 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 Funktionen 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.
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 diese Funktion üblicherweise während der Startphase des Skripts 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 Funktionen ermöglichen die Verwendung einer Fenstergruppe durch Angabe von ahk_group MeineGruppeName im FensterTitel-Parameter. Die Funktionen WinMinimize, WinMaximize, WinRestore, WinHide, WinShow, WinClose und WinKill arbeiten mit allen Fenstern der Gruppe. Um stattdessen nur mit dem obersten Fenster zu arbeiten, gehen Sie wie folgt vor:
WinHide WinExist("ahk_group MeineGruppe")
Andere fensterspezifische Funktionen wie WinActivate und WinExist arbeiten hingegen nur mit dem obersten Fenster der Gruppe.
GroupActivate, GroupDeactivate, GroupClose
Drücken Sie einen Hotkey, um alle geöffneten MSIE-Fenster durchzugehen.
; Im globalen Code, zur Auswertung in der Startphase: GroupAdd "MSIE", "ahk_class IEFrame" ; Fügt nur Internet-Explorer-Fenster zur Gruppe hinzu. ; 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 globalen Code, zur Auswertung in der Startphase:
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"
; Weist einen Hotkey zu, um jedes Outlook-Fenster nacheinander zu besuchen.
Numpad5::GroupActivate "mail"