Funzione di callback MONITORENUMPROC (winuser.h)

Una funzione MonitorEnumProc è una funzione di callback definita dall'applicazione chiamata dalla funzione EnumDisplayMonitors .

Un valore di tipo MONITORENUMPROC è un puntatore a una funzione MonitorEnumProc .

Sintassi

MONITORENUMPROC Monitorenumproc;

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

Parametri

unnamedParam1

Handle per il monitor di visualizzazione. Questo valore sarà sempre diverso da NULL.

unnamedParam2

Handle per un contesto di dispositivo.

Il contesto di dispositivo ha attributi di colore appropriati per il monitor di visualizzazione identificato da hMonitor. L'area di ritaglio del contesto di dispositivo è impostata sull'intersezione dell'area visibile del contesto di dispositivo identificato dal parametro hdc di EnumDisplayMonitors, il rettangolo a cui punta il parametro lprcClip di EnumDisplayMonitors e il rettangolo di monitoraggio dello schermo.

Questo valore è NULL se il parametro hdc di EnumDisplayMonitors è NULL.

unnamedParam3

Puntatore a una struttura RECT .

Se hdcMonitor è diverso da NULL, questo rettangolo è l'intersezione dell'area di ritaglio del contesto di dispositivo identificato da hdcMonitor e dal rettangolo di monitoraggio dello schermo. Le coordinate del rettangolo sono coordinate del contesto di dispositivo.

Se hdcMonitor è NULL, questo rettangolo è il rettangolo di monitoraggio dello schermo. Le coordinate del rettangolo sono coordinate dello schermo virtuale.

unnamedParam4

Dati definiti dall'applicazione che EnumDisplayMonitors passa direttamente alla funzione di enumerazione.

Valore restituito

Per continuare l'enumerazione, restituire TRUE.

Per arrestare l'enumerazione, restituire FALSE.

Commenti

È possibile utilizzare la funzione EnumDisplayMonitors per enumerare il set di monitoraggi che intersecano l'area visibile di un contesto di dispositivo specificato e, facoltativamente, un rettangolo di ritaglio. A tale scopo, impostare il parametro hdc su un valore non NULL e impostare il parametro lprcClip in base alle esigenze.

È anche possibile usare la funzione EnumDisplayMonitors per enumerare uno o più monitoraggi sullo schermo sul desktop, senza fornire un contesto di dispositivo. A tale scopo, impostare il parametro hdc di EnumDisplayMonitors su NULL e impostare il parametro lprcClip in base alle esigenze.

In tutti i casi , EnumDisplayMonitors chiama una volta una funzione MonitorEnumProc specificata per ogni monitor di visualizzazione nel set di enumerazioni calcolate. La funzione MonitorEnumProc riceve sempre un handle per il monitor di visualizzazione.

Se il parametro hdc di EnumDisplayMonitors è diverso da NULL, la funzione MonitorEnumProc riceve anche un handle in un contesto di dispositivo il cui formato di colore è appropriato per il monitor di visualizzazione. È quindi possibile disegnare nel contesto del dispositivo in modo ottimale per il monitor dello schermo.

Requisiti

Vedi anche

EnumDisplayMonitors

Funzioni monitor multiple

Panoramica dei monitoraggi multipli