WinGetList

Gibt ein Array von eindeutigen IDs (HWNDs) für alle existierenden Fenster gemäß bestimmter Kriterien zurück.

HWNDs := WinGetList(FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)

Parameter

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Typ: Zeichenkette, Integer oder Objekt

Wenn jeder dieser Parameter leer ist oder weggelassen wird, werden alle Fenster im gesamten System abgerufen. Andernfalls 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 (wie von Window Spy angezeigt).

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. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit DetectHiddenWindows bzw. DetectHiddenText geändert werden kann. Verwendet man reine HWNDs, werden versteckte Fenster immer erkannt. Standardmäßig kann ein Fenstertitel den angegebenen FensterTitel oder AusnahmeTitel an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.

Rückgabewert

Typ: Array

Diese Funktion gibt ein Array von eindeutigen IDs (HWNDs) für alle existierenden Fenster gemäß der angegebenen Kriterien zurück. Wenn kein Fenster gefunden wurde, wird ein leeres Array zurückgegeben.

Wenn zum Beispiel der Rückgabewert in eine Variable namens HWNDs gespeichert wird und zwei Fenster vorhanden sind, gibt HWNDs[1] das HWND des ersten Fensters, HWNDs[2] das HWND des zweiten Fensters und HWNDs.Length die Zahl 2 zurück.

Die Fenster werden von oben nach unten abgerufen (entsprechend ihrer Stapelung auf dem Desktop).

WinGetCount, Win-Funktionen, Control-Funktionen

Beispiele

Besucht alle Fenster im System und zeigt Informationen zu jedem an.

IDs := WinGetList(,, "Program Manager")
for diese_ID in IDs
{
    WinActivate diese_ID
    diese_Klasse := WinGetClass(diese_ID)
    dieser_Titel := WinGetTitle(diese_ID)
    Ergebnis := MsgBox(
    (
        "Gehe alle Fenster durch
        " A_Index " von " IDs.Length "
        ahk_id " diese_ID "
        ahk_class " diese_Klasse "
        " dieser_Titel "

        Weiter?"
    ),, 4)
    if (Ergebnis = "No")
        break
}