Fonction de rappel MONITORENUMPROC (winuser.h)

Fonction de rappel définie par l’application utilisée avec la fonction EnumDisplayMonitors . Le type MONITORENUMPROC définit un pointeur vers cette fonction de rappel. MonitorEnumProc est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

MONITORENUMPROC Monitorenumproc;

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

Paramètres

unnamedParam1

Type : HMONITOR

Handle du moniteur d’affichage. Cette valeur est toujours non NULL. Ce paramètre est généralement nommé hMonitor.

unnamedParam2

Type : HDC

Handle vers un contexte d’appareil. Ce paramètre est généralement nommé hdcMonitor.

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 hdcd’EnumDisplayMonitors a été NULL.

unnamedParam3

Type : LPRECT

Pointeur vers une structure RECT . Ce paramètre est généralement nommé lprcMonitor.

Si hdcMonitor n’est pas NULL, ce rectangle est l’intersection de la zone de découpage du contexte de l’appareil identifié par hdcMonitor et le 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 de rectangle sont des coordonnées d’écran virtuel.

unnamedParam4

Type : LPARAM

Données définies par l’application que EnumDisplayMonitors transmet directement à la fonction d’énumération. Ce paramètre est généralement nommé dwData.

Valeur retournée

Type : BOOL

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 de 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 selon les besoins.

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és. La fonction MonitorEnumProc reçoit toujours un handle pour le moniteur d’affichage.

Si le paramètre hdcd’EnumDisplayMonitors n’est pas NULL, la fonction MonitorEnumProc reçoit également un handle vers 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 de manière optimale pour le moniteur d’affichage.

Spécifications

Voir aussi

EnumDisplayMonitors

Fonctions de moniteurs d’affichage multiples

Vue d’ensemble de plusieurs moniteurs d’affichage