WinGetID

Gibt die eindeutige ID (HWND) eines bestimmten Fensters zurück.

HWND := WinGetID(FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)

Parameter

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Typ: Zeichenkette, Integer oder Objekt

Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das Zuletzt Gefundene Fenster verwendet. 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: Integer

Diese Funktion gibt das Fensterhandle (HWND) des angegebenen Fensters zurück.

Fehlerbehandlung

Es wird ein TargetError ausgelöst, wenn das Fenster nicht gefunden werden konnte.

Bemerkungen

Die Gültigkeit einer eindeutigen ID (HWND) ist an die Lebensdauer des zugehörigen Fensters gebunden. Mit anderen Worten: Wenn eine Anwendung neu gestartet wird, erhalten all ihre Fenster und Steuerelemente neue HWNDs.

Mit MouseGetPos kann das HWND des Fensters unter dem Mauszeiger abgerufen werden.

Um das HWND eines Steuerelements zu erhalten, verwenden Sie ControlGetHwnd oder ähnliches.

WinGetIDLast, WinExist, ControlGetHwnd, Gui.Hwnd, Win-Funktionen, Control-Funktionen

Beispiele

Maximiert das aktive Fenster und meldet dessen HWND.

AktiveID := WinGetID("A")
WinMaximize AktiveID
MsgBox "HWND des aktiven Fensters ist " AktiveID