ChildWindowFromPointEx-Funktion (winuser.h)
Bestimmt, welche der untergeordneten Fenster, die zum angegebenen übergeordneten Fenster gehören, falls vorhanden, den angegebenen Punkt enthält. Die Funktion kann unsichtbare, deaktivierte und transparente untergeordnete Fenster ignorieren. Die Suche ist auf unmittelbare untergeordnete Fenster beschränkt. Enkelkinder und tiefere Nachkommen werden nicht gesucht.
Syntax
HWND ChildWindowFromPointEx(
[in] HWND hwnd,
[in] POINT pt,
[in] UINT flags
);
Parameter
[in] hwnd
Typ: HWND
Ein Handle für das übergeordnete Fenster.
[in] pt
Typ: POINT
Eine Struktur, die die Clientkoordinaten (relativ zu hwndParent) des zu überprüfenden Punkts definiert.
[in] flags
Typ: UINT
Die untergeordneten Fenster, die übersprungen werden sollen. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.
Rückgabewert
Typ: HWND
Der Rückgabewert ist ein Handle für das erste untergeordnete Fenster, das den Punkt enthält und die von uFlags angegebenen Kriterien erfüllt. Wenn sich der Punkt innerhalb des übergeordneten Fensters befindet, aber nicht innerhalb eines untergeordneten Fensters, das die Kriterien erfüllt, ist der Rückgabewert ein Handle für das übergeordnete Fenster. Wenn der Punkt außerhalb des übergeordneten Fensters liegt oder die Funktion fehlschlägt, ist der Rückgabewert NULL.
Hinweise
Das System verwaltet eine interne Liste, die die Handles der untergeordneten Fenster enthält, die einem übergeordneten Fenster zugeordnet sind. Die Reihenfolge der Handles in der Liste hängt von der Z-Reihenfolge der untergeordneten Fenster ab. Wenn mehr als ein untergeordnetes Fenster den angegebenen Punkt enthält, gibt das System ein Handle an das erste Fenster in der Liste zurück, das den Punkt enthält und die von uFlags angegebenen Kriterien erfüllt.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winuser.h (einschließlich Windows.h) |
Bibliothek | User32.lib |
DLL | User32.dll |
APIs | ext-ms-win-ntuser-window-l1-1-4 (eingeführt in Windows 10, Version 10.0.14393) |
Siehe auch
Konzept
Andere Ressourcen
Referenz