MonitorFromRect, fonction (winuser.h)

  • Article

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