MonitorFromWindow-Funktion (winuser.h)

Artikel
08/27/2023

Die MonitorFromWindow-Funktion ruft einen Handle für den Anzeigemonitor ab, der den größten Bereich der Schnittmenge mit dem umgebenden Rechteck eines angegebenen Fensters aufweist.

Syntax

HMONITOR MonitorFromWindow(
  [in] HWND  hwnd,
  [in] DWORD dwFlags
);

Parameter

[in] hwnd

Ein Handle für das interessante Fenster.

[in] dwFlags

Bestimmt den Rückgabewert der Funktion, wenn das Fenster keinen Anzeigemonitor überschneidet.

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
MONITOR_DEFAULTTONEAREST	Gibt ein Handle an den Anzeigemonitor zurück, der dem Fenster am nächsten ist.
MONITOR_DEFAULTTONULL	Gibt NULL zurück.
MONITOR_DEFAULTTOPRIMARY	Gibt ein Handle an den primären Anzeigemonitor zurück.

Rückgabewert

Wenn das Fenster ein oder mehrere Anzeigemonitorrechtecke überschneidet, ist der Rückgabewert ein HMONITOR-Handle für den Anzeigemonitor, der den größten Bereich der Schnittmenge mit dem Fenster aufweist.

Wenn das Fenster keinen Anzeigemonitor überschneidet, hängt der Rückgabewert vom Wert von dwFlags ab.

Hinweise

Wenn das Fenster derzeit minimiert ist, verwendet MonitorFromWindow das Rechteck des Fensters, bevor es minimiert wurde.

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

Weitere Informationen

MonitorFromPoint

MonitorFromRect

Funktionen für mehrere Anzeigemonitore

Übersicht über mehrere Bildschirme

Freigeben über