MonitorFromWindow, fonction (winuser.h)

  • Article

La fonction MonitorFromWindow récupère un handle pour le moniteur d’affichage qui a la plus grande zone d’intersection avec le rectangle englobant d’une fenêtre spécifiée.

Syntaxe

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

Paramètres

[in] hwnd

Handle de la fenêtre d’intérêt.

[in] dwFlags

Détermine la valeur de retour de la fonction si la fenêtre 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 de la fenêtre.
MONITOR_DEFAULTTONULL
 Retourne NULL.
MONITOR_DEFAULTTOPRIMARY
 Retourne un handle au moniteur d’affichage principal.

Valeur retournée

Si la fenêtre 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 la fenêtre.

Si la fenêtre ne croise pas un moniteur d’affichage, la valeur de retour dépend de la valeur de dwFlags.

Remarques

Si la fenêtre est actuellement réduite, MonitorFromWindow utilise le rectangle de la fenêtre avant sa réduction.

Configuration requise

   
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

MonitorFromRect

Fonctions de plusieurs moniteurs d’affichage

Vue d’ensemble de plusieurs moniteurs d’affichage