MonitorFromRect-Funktion (winuser.h)

Artikel
03/09/2024

Die MonitorFromRect-Funktion ruft ein Handle für den Anzeigemonitor ab, der den größten Schnittbereich mit einem angegebenen Rechteck aufweist.

Syntax

HMONITOR MonitorFromRect(
  [in] LPCRECT lprc,
  [in] DWORD   dwFlags
);

Parameter

[in] lprc

Ein Zeiger auf eine RECT-Struktur , die das für virtuelle Bildschirmkoordinaten interessante Rechteck angibt.

[in] dwFlags

Bestimmt den Rückgabewert der Funktion, wenn das Rechteck 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 Rechteck am nächsten liegt.
MONITOR_DEFAULTTONULL	Gibt NULL zurück.
MONITOR_DEFAULTTOPRIMARY	Gibt ein Handle an den primären Anzeigemonitor zurück.

Rückgabewert

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

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

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 (windows.h einschließen)
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

MonitorFromWindow

Funktionen für mehrere Anzeigemonitore

Übersicht über mehrere Anzeigemonitore

Freigeben über