DefScreenSaverProc-Funktion (scrnsave.h)

Artikel
08/25/2023

Stellt die Standardverarbeitung für alle Nachrichten bereit, die von einer Bildschirmschoneranwendung nicht verarbeitet werden.

Syntax

LRESULT DefScreenSaverProc(
  HWND   hWnd,
  UINT   msg,
  WPARAM wParam,
  LPARAM lParam
);

Parameter

hWnd

Typ: HWND

Der Bezeichner des Bildschirmschonerfensters.

msg

Typ: UINT

Die zu verarbeitende Meldung. Die DefScreenSaverProc-Funktion reagiert auf Nachrichten, die sich auf den Vorgang des Bildschirmschoners auswirken, wie im Abschnitt Hinweise beschrieben.

Wenn eine Bildschirmschoneranwendung als Reaktion auf eine dieser Nachrichten eine andere Aktion ausführen muss, sollte die ScreenSaverProc-Fensterprozedur der Anwendung die Nachricht verarbeiten.

wParam

Typ: WPARAM

Zusätzliche meldungsspezifische Informationen.

lParam

Typ: LPARAM

Zusätzliche meldungsspezifische Informationen.

Rückgabewert

Typ: LONG

Der Rückgabewert gibt das Ergebnis der Nachrichtenverarbeitung an und hängt von der gesendeten Nachricht ab.

Hinweise

Die ScreenSaverProc-Fensterprozedur einer Bildschirmschoneranwendung sollte DefScreenSaverProc anstelle der DefWindowProc-Funktion verwenden, um die Standardnachrichtenverarbeitung bereitzustellen. Die DefScreenSaverProc-Funktion übergibt alle Meldungen, die sich nicht auf den Bildschirmschonervorgang auswirken, an DefWindowProc.

In der folgenden Tabelle wird beschrieben, wie DefScreenSaverProc eine Vielzahl von Fenstermeldungen verarbeitet.

`Message`	BESCHREIBUNG
WM_ACTIVATE, WM_ACTIVATEAPP , WM_NCACTIVATE	Schließt den Bildschirmschoner, wenn der wParam-ParameterFALSE ist. Der wParam-WertFALSE gibt an, dass der Bildschirmschoner den Eingabefokus verliert. Der Bildschirmschoner wird geschlossen, indem eine WM_CLOSE Nachricht gesendet wird.
WM_SETCURSOR	Entfernt den Cursor vom Bildschirm, indem der Cursor auf NULL festgelegt wird.
WM_LBUTTONDOWN, WM_RBUTTONDOWN, WM_MBUTTONDOWN, WM_KEYDOWN, WM_KEYUP, WM_MOUSEMOVE	Ruft die PostQuitMessage-Funktion auf, um den Bildschirmschoner zu schließen.
WM_DESTROY	Sendet eine WM_CLOSE Nachricht, um das Bildschirmschonerfenster zu schließen.
WM_SYSCOMMAND	Gibt FALSE zurück, wenn der wParam-Parameter von WM_SYSCOMMANDentweder SC_CLOSE oder SC_SCREENSAVE ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	scrnsave.h
Bibliothek	Scrnsave.lib
DLL	Keine

Share via