Freigeben über


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.

Wert Bedeutung
CWP_ALL
0x0000
Überspringt keine untergeordneten Fenster
CWP_SKIPDISABLED
0x0002
Überspringt deaktivierte untergeordnete Fenster
CWP_SKIPINVISIBLE
0x0001
Überspringt unsichtbare untergeordnete Fenster
CWP_SKIPTRANSPARENT
0x0004
Überspringt transparente untergeordnete Fenster

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

PUNKT

Referenz

WindowFromPoint

Windows