MonitorFromRect, fonction (winuser.h)

Article
03/04/2024

La fonction MonitorFromRect récupère un handle pour le moniteur d’affichage qui a la plus grande zone d’intersection avec un rectangle spécifié.

Syntaxe

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

Paramètres

[in] lprc

Pointeur vers une structure RECT qui spécifie le rectangle d’intérêt dans les coordonnées d’écran virtuel.

[in] dwFlags

Détermine la valeur de retour de la fonction si le rectangle ne croise aucun moniteur d’affichage.

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
MONITOR_DEFAULTTONEAREST	Retourne un handle au moniteur d’affichage le plus proche du rectangle.
MONITOR_DEFAULTTONULL	Retourne NULL.
MONITOR_DEFAULTTOPRIMARY	Retourne un handle au moniteur d’affichage principal.

Valeur retournée

Si le rectangle croise un ou plusieurs rectangles de moniteur d’affichage, la valeur de retour est un handle HMONITOR pour le moniteur d’affichage qui a la plus grande zone d’intersection avec le rectangle.

Si le rectangle ne croise pas un moniteur d’affichage, la valeur de retour dépend de la valeur de dwFlags.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

MonitorFromPoint

MonitorFromWindow

Fonctions de plusieurs moniteurs d’affichage

Vue d’ensemble de plusieurs moniteurs d’affichage

Partager via