Fonction de rappel MONITORENUMPROC (winuser.h)

Une fonction MonitorEnumProc est une fonction de rappel définie par l’application appelée par la fonction EnumDisplayMonitors .

Une valeur de type MONITORENUMPROC est un pointeur vers une fonction MonitorEnumProc .

Syntaxe

MONITORENUMPROC Monitorenumproc;

BOOL Monitorenumproc(
  HMONITOR unnamedParam1,
  HDC unnamedParam2,
  LPRECT unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Paramètres

unnamedParam1

Handle pour le moniteur d’affichage. Cette valeur est toujours non NULL.

unnamedParam2

Handle d'un contexte de périphérique.

Le contexte de l’appareil a des attributs de couleur appropriés pour le moniteur d’affichage identifié par hMonitor. La zone de découpage du contexte de l’appareil est définie sur l’intersection de la région visible du contexte de l’appareil identifiée par le paramètre hdcd’EnumDisplayMonitors, le rectangle vers lequel pointe le paramètre lprcClipd’EnumDisplayMonitors et le rectangle du moniteur d’affichage.

Cette valeur est NULL si le paramètre hdc de EnumDisplayMonitors était NULL.

unnamedParam3

Pointeur vers une structure RECT .

Si hdcMonitor n’a pas la valeur NULL, ce rectangle est l’intersection de la zone de découpage du contexte de l’appareil identifié par hdcMonitor et du rectangle du moniteur d’affichage. Les coordonnées rectangle sont des coordonnées de contexte d’appareil.

Si hdcMonitor a la valeur NULL, ce rectangle est le rectangle du moniteur d’affichage. Les coordonnées rectangle sont des coordonnées d’écran virtuel.

unnamedParam4

Données définies par l’application que EnumDisplayMonitors transmet directement à la fonction d’énumération.

Valeur retournée

Pour continuer l’énumération, retournez TRUE.

Pour arrêter l’énumération, retournez FALSE.

Remarques

Vous pouvez utiliser la fonction EnumDisplayMonitors pour énumérer l’ensemble des moniteurs d’affichage qui croisent la région visible d’un contexte d’appareil spécifié et, éventuellement, un rectangle de découpage. Pour ce faire, définissez le paramètre hdc sur une valeur non NULL et définissez le paramètre lprcClip si nécessaire.

Vous pouvez également utiliser la fonction EnumDisplayMonitors pour énumérer un ou plusieurs moniteurs d’affichage sur le bureau, sans fournir de contexte d’appareil. Pour ce faire, définissez le paramètre hdcd’EnumDisplayMonitors sur NULL et définissez le paramètre lprcClip si nécessaire.

Dans tous les cas, EnumDisplayMonitors appelle une fonction MonitorEnumProc spécifiée une fois pour chaque moniteur d’affichage dans le jeu d’énumération calculé. La fonction MonitorEnumProc reçoit toujours un handle pour le moniteur d’affichage.

Si le paramètre hdc de EnumDisplayMonitors n’a pas la valeur NULL, la fonction MonitorEnumProc reçoit également un handle pour un contexte d’appareil dont le format de couleur est approprié pour le moniteur d’affichage. Vous pouvez ensuite peindre dans le contexte de l’appareil d’une manière optimale pour le moniteur d’affichage.

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)

Voir aussi

EnumDisplayMonitors

Fonctions de plusieurs moniteurs d’affichage

Vue d’ensemble de plusieurs moniteurs d’affichage