RealChildWindowFromPoint-Funktion (winuser.h)

Artikel
03/04/2024

Ruft ein Handle zum untergeordneten Fenster am angegebenen Punkt ab. Die Suche ist auf die unmittelbar untergeordneten Fenster beschränkt. Enkelkinder und tiefere Nachfahrfenster werden nicht durchsucht.

Syntax

HWND RealChildWindowFromPoint(
  [in] HWND  hwndParent,
  [in] POINT ptParentClientCoords
);

Parameter

[in] hwndParent

Typ: HWND

Ein Handle für das Fenster, dessen untergeordnetes Element abgerufen werden soll.

[in] ptParentClientCoords

Typ: POINT

Eine POINT-Struktur , die die Clientkoordinaten des zu überprüfenden Punkts definiert.

Rückgabewert

Typ: HWND

Der Rückgabewert ist ein Handle für das untergeordnete Fenster, das den angegebenen Punkt enthält.

Hinweise

RealChildWindowFromPoint behandelt HTTRANSPARENT-Bereiche eines Standardsteuerelements anders als andere Bereiche des Steuerelements; Es gibt das untergeordnete Fenster hinter einem transparenten Teil eines Steuerelements zurück. Im Gegensatz dazu behandelt ChildWindowFromPointHTTRANSPARENT-Bereiche eines Steuerelements genauso wie andere Bereiche. Wenn sich der Punkt beispielsweise in einem transparenten Bereich einer Groupbox befindet, gibt RealChildWindowFromPoint das untergeordnete Fenster hinter einer Groupbox zurück, während ChildWindowFromPoint die Groupbox zurückgibt. Beide APIs geben jedoch ein statisches Feld zurück, obwohl es auch HTTRANSPARENT zurückgibt.

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)