MonitorFromRect-Funktion (winuser.h)

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