ChildWindowFromPoint-Funktion (winuser.h)

Artikel
03/15/2023

Bestimmt, welche untergeordneten Fenster, die zu einem übergeordneten Fenster gehören, falls vorhanden, den angegebenen Punkt enthält. Die Suche ist auf die unmittelbar untergeordneten Fenster beschränkt. Enkel und tiefere Nachkommafenster werden nicht durchsucht.

Um bestimmte untergeordnete Fenster zu überspringen, verwenden Sie die ChildWindowFromPointEx-Funktion .

Syntax

HWND ChildWindowFromPoint(
  [in] HWND  hWndParent,
  [in] POINT Point
);

Parameter

[in] hWndParent

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in] Point

Typ: POINT

Eine Struktur, die die Clientkoordinaten relativ zu hWndParent des zu überprüfenden Punkts definiert.

Rückgabewert

Typ: HWND

Der Rückgabewert ist ein Handle für das untergeordnete Fenster, das den Punkt enthält, auch wenn das untergeordnete Fenster ausgeblendet oder deaktiviert ist. Wenn der Punkt außerhalb des übergeordneten Fensters liegt, ist der Rückgabewert NULL. Wenn sich der Punkt innerhalb des übergeordneten Fensters, aber nicht innerhalb eines untergeordneten Fensters befindet, ist der Rückgabewert ein Handle für das übergeordnete Fenster.

Hinweise

Das System verwaltet eine interne Liste, die die Handles der untergeordneten Fenster enthält, die einem übergeordneten Fenster zugeordnet sind. Die Reihenfolge der Ziehpunkte 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.

ChildWindowFromPoint behandelt einen HTTRANSPARENT-Bereich eines Standardsteuerelements genauso wie andere Teile des Steuerelements. Im Gegensatz dazu behandelt RealChildWindowFromPoint einen HTTRANSPARENT-Bereich unterschiedlich; Das untergeordnete Fenster hinter einem transparenten Bereich eines Steuerelements wird zurückgegeben. Wenn sich der Punkt beispielsweise in einem transparenten Bereich eines Groupbox-Felds befindet, gibt ChildWindowFromPoint die Groupbox zurück, während RealChildWindowFromPoint das untergeordnete Fenster hinter dem Groupbox zurückgibt. Beide APIs geben jedoch ein statisches Feld zurück, obwohl es auch HTTRANSPARENT zurückgibt.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Symbolleiste für Kombinationsfelde unter Verwenden von Kombinationsfeldern.

Anforderungen


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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-4 (eingeführt in Windows 10, Version 10.0.14393)