_WinAPI_GetWindow
Beschreibung anzeigen in
Ermittelt das Handle eines Fensters, das ein bestimmtes Verhältnis (Z-Anordnung oder Besitzer) zu dem angegebenen Fenster hat
#include <WinAPISysWin.au3>
_WinAPI_GetWindow ( $hWnd, $iCmd )
Parameter
| $hWnd | Handle des Fensters. Das ermittelte Fenster-Handle ist relativ zu diesem Fenster, basierend auf dem Wert im $iCmd Parameter. |
| $iCmd | Gibt das Verhältnis an, das zwischen dem angegebenen Fenster und dem Fenster, dessen Handle ermittelt werden soll, besteht. Dieser Parameter kann einer der folgenden Werte sein: $GW_CHILD - Das ermittelte Handle identifiziert das Child-Fenster an der Spitze der Z-Anordnung, falls das angegebene Fenster ein Parent-Fenster ist; andernfalls ist das ermittelte Handle 0. Die Funktion prüft nur auf Child-Fenster des angegebenen Fensters. Sie prüft dann keine abkömmlichen Fenster. $GW_HWNDFIRST - Das ermittelte Handle identifiziert das Fenster gleichen Typs, welches am höchsten in der Z-Anordnung ist. Falls das angegebene Fenster ein Topmost-Fenster ist, identifiziert das Handle das Topmost-Fenster, welches am höchsten in der Z-Anordnung ist. Falls das angegebene Fenster ein Top-Level Fenster ist, identifiziert das Handle das Top-Level Fenster, welches am höchsten in der Z-Anordnung ist. Falls das angegebene Fenster ein Child-Fenster ist, identifiziert das Handle das Fenster auf gleicher Ebene, welches am höchsten in der Z-Anordnung ist. $GW_HWNDLAST - Das ermittelte Handle identifiziert das Fenster gleichen Typs, welches am niedrigsten in der Z-Anordnung ist. Falls das angegebene Fenster ein Topmost-Fenster ist, identifiziert das Handle das Topmost-Fenster, welches am niedrigsten in der Z-Anordnung ist. Falls das angegebene Fenster ein Top-Level Fenster ist, identifiziert das Handle das Top-Level Fenster, welches am niedrigsten in der Z-Anordnung ist. Falls das angegebene Fenster ein Child-Fenster ist, identifiziert das Handle das Fenster auf gleicher Ebene, welches am niedrigsten in der Z-Anordnung ist. $GW_HWNDNEXT - Das ermittelte Handle identifiziert das Fenster, das in der Z-Anordnung direkt unter dem angegebenen Fenster ist. Falls das angegebene Fenster ein Topmost-Fenster ist, identifiziert das Handle das Topmost-Fenster, welches direkt unter dem angegebenen Fenster in der Z-Anordnung ist. Falls das angegebene Fenster ein Top-Level Fenster ist, identifiziert das Handle das Top-Level Fenster, welches direkt unter dem angegebenen Fenster in der Z-Anordnung ist. Falls das angegebene Fenster ein Child-Fenster ist, identifiziert das Handle das Fenster auf gleicher Ebene, welches direkt unter dem angegebenen Fenster in der Z-Anordnung ist. $GW_HWNDPREV - Das ermittelte Handle identifiziert das Fenster, das in der Z-Anordnung direkt über dem angegebenen Fenster ist. Falls das angegebene Fenster ein Topmost-Fenster ist, identifiziert das Handle das Topmost-Fenster, welches direkt über dem angegebenen Fenster in der Z-Anordnung ist. Falls das angegebene Fenster ein Top-Level Fenster ist, identifiziert das Handle das Top-Level Fenster, welches direkt über dem angegebenen Fenster in der Z-Anordnung ist. Falls das angegebene Fenster ein Child-Fenster ist, identifiziert das Handle das Fenster auf gleicher Ebene, welches direkt über dem angegebenen Fenster in der Z-Anordnung ist. $GW_OWNER - Das ermittelte Handle identifiziert den Besitzer des angegebenen Fensters, sofern vorhanden |
Rückgabewert
| Erfolg: | Das Fensterhandle |
| Fehler: | 0. Es ist _WinAPI_GetLastError() aufzurufen um erweiterte Fehlerinformationen zu erhalten. |
Bemerkungen
Die EnumChildWindows Funktion ist zuverlässiger als der Aufruf von GetWindow in einer Schleife. Eine Anwendung die GetWindow aufruft, um diese Aufgabe zu erledigen, riskiert in einer Endlosschleife gefangen zu werden oder referenziert womöglich ein Fenster, das zerstört wurde.
Oben genannte Konstanten benötigen #include <WinAPIConstants.au3>
Siehe auch
Suche nach GetWindow in der MSDN Bibliothek.