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) |