Funzione DefScreenSaverProc (scrnsave.h)

Articolo
03/01/2024

Fornisce l'elaborazione predefinita per tutti i messaggi non elaborati da un'applicazione screen saver.

Sintassi

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

Parametri

hWnd

Tipo: HWND

Identificatore della finestra screen saver.

msg

Tipo: UINT

Messaggio da elaborare. La funzione DefScreenSaverProc risponde ai messaggi che influiscono sull'operazione dello screen saver, come descritto nella sezione Osservazioni.

Se un'applicazione screen saver deve eseguire un'azione diversa in risposta a uno di questi messaggi, la routine della finestra ScreenSaverProc dell'applicazione deve elaborare il messaggio.

wParam

Tipo: WPARAM

Ulteriori informazioni specifiche del messaggio.

lParam

Tipo: LPARAM

Ulteriori informazioni specifiche del messaggio.

Valore restituito

Tipo: LONG

Il valore restituito specifica il risultato dell'elaborazione del messaggio e dipende dal messaggio inviato.

Commenti

La procedura della finestra ScreenSaverProc di un'applicazione screen saver deve usare DefScreenSaverProc anziché la funzione DefWindowProc per fornire l'elaborazione predefinita dei messaggi. La funzione DefScreenSaverProc passa tutti i messaggi che non influiscono sull'operazione screen saver a DefWindowProc.

La tabella seguente descrive come DefScreenSaverProc elabora un'ampia gamma di messaggi finestra.

Message	Descrizione
WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE	Chiude lo screen saver se il parametro wParam è FALSE. Un valore wParamfalse indica che lo screen saver sta perdendo lo stato attivo per l'input. Lo screen saver viene chiuso inviando un messaggio di WM_CLOSE .
WM_SETCURSOR	Rimuove il cursore dalla schermata impostando il cursore su NULL.
WM_LBUTTONDOWN, WM_RBUTTONDOWN, WM_MBUTTONDOWN, WM_KEYDOWN, WM_KEYUP, WM_MOUSEMOVE	Chiama la funzione PostQuitMessage per chiudere lo screen saver.
WM_DESTROY	Invia un messaggio WM_CLOSE per chiudere la finestra dello screen saver.
WM_SYSCOMMAND	Restituisce FALSE se il parametro wParam di WM_SYSCOMMAND è SC_CLOSE o SC_SCREENSAVE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	scrnsave.h
Libreria	Scrnsave.lib
DLL	Nessuno

Condividi tramite