MONITORENUMPROC-Rückruffunktion (winuser.h)

Eine MonitorEnumProc-Funktion ist eine anwendungsdefinierte Rückruffunktion, die von der EnumDisplayMonitors-Funktion aufgerufen wird.

Ein Wert vom Typ MONITORENUMPROC ist ein Zeiger auf eine MonitorEnumProc-Funktion .

Syntax

MONITORENUMPROC Monitorenumproc;

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

Parameter

unnamedParam1

Ein Handle für den Anzeigemonitor. Dieser Wert ist immer nicht NULL.

unnamedParam2

Ein Handle für einen Gerätekontext.

Der Gerätekontext verfügt über Farbattribute, die für den von hMonitor identifizierten Anzeigemonitor geeignet sind. Der Abschneidebereich des Gerätekontexts wird auf den Schnittpunkt des sichtbaren Bereichs des Gerätekontexts festgelegt, der durch den hdc-Parameter von EnumDisplayMonitors, das Rechteck, auf das durch den lprcClip-Parameter von EnumDisplayMonitors verwiesen wird, und dem Anzeigemonitor-Rechteck.

Dieser Wert ist NULL , wenn der hdc-Parameter von EnumDisplayMonitorsNULL lautet.

unnamedParam3

Ein Zeiger auf eine RECT-Struktur .

Wenn hdcMonitor nicht NULL ist, ist dieses Rechteck die Schnittmenge des Ausschneidebereichs des Gerätekontexts, der von hdcMonitor und dem Rechteck des Anzeigemonitors identifiziert wird. Die Rechteckkoordinaten sind Gerätekontextkoordinaten.

Wenn hdcMonitorNULL ist, ist dieses Rechteck das Anzeigemonitorrechteck. Bei den Rechteckkoordinaten handelt es sich um Virtuelle Bildschirmkoordinaten.

unnamedParam4

Anwendungsdefinierte Daten, die EnumDisplayMonitors direkt an die Enumerationsfunktion übergibt.

Rückgabewert

Um die Enumeration fortzusetzen, geben Sie TRUE zurück.

Um die Enumeration zu beenden, geben Sie FALSE zurück.

Hinweise

Sie können die EnumDisplayMonitors-Funktion verwenden, um den Satz von Anzeigemonitoren aufzulisten, der den sichtbaren Bereich eines angegebenen Gerätekontexts und optional ein Abschneidrechteck überschneiden. Legen Sie hierzu den hdc-Parameter auf einen Wert ohne NULL fest, und legen Sie den lprcClip-Parameter nach Bedarf fest.

Sie können auch die EnumDisplayMonitors-Funktion verwenden, um einen oder mehrere der Anzeigemonitore auf dem Desktop aufzulisten, ohne einen Gerätekontext anzugeben. Legen Sie hierzu den hdc-Parameter von EnumDisplayMonitors auf NULL fest, und legen Sie den parameter lprcClip nach Bedarf fest.

In allen Fällen ruft EnumDisplayMonitors eine angegebene MonitorEnumProc-Funktion einmal für jeden Anzeigemonitor im berechneten Enumerationssatz auf. Die MonitorEnumProc-Funktion empfängt immer ein Handle für den Anzeigemonitor.

Wenn der hdc-Parameter von EnumDisplayMonitors nicht NULL ist, empfängt die MonitorEnumProc-Funktion auch ein Handle für einen Gerätekontext, dessen Farbformat für den Anzeigemonitor geeignet ist. Anschließend können Sie den Gerätekontext so zeichnen, dass es für den Anzeigemonitor optimal ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)

Weitere Informationen

EnumDisplayMonitors

Funktionen für mehrere Anzeigemonitore

Übersicht über mehrere Bildschirme