ScreenSaverConfigureDialog

3.1

  #include <scrnsave.h>    

  BOOL ScreenSaverConfigureDialog(hdlg, wmsg, wParam, lParam)    
  HWND hdlg; /* handle of dialog box */
  UINT wmsg; /* message */
  WPARAM wParam; /* first message parameter */
  LPARAM lParam; /* second message parameter */

The ScreenSaverConfigureDialog function receives messages sent to a screen saver application's configuration dialog box. A screen saver application that supports user configuration must provide this function.

Parameters

hdlg

Identifies the configuration dialog box.

wmsg

Specifies the message.

wParam

Specifies 16 bits of additional message-dependent information.

lParam

Specifies 32 bits of additional message-dependent information.

Return Value

The return value is nonzero if the function processes the message or zero if it does not, except in response to a WM_INITDIALOG message. In response to a WM_INITDIALOG message, ScreenSaverConfigureDialog should return zero if it calls the SetFocus function to set the input focus to one of the controls in the dialog box. Otherwise, it should return nonzero, in which case the system sets the input focus to the first control in the dialog box that can be given the focus.

Comments

An application uses the MakeProcInstance function with ScreenSaverConfigureDialog to display a configuration dialog box.

The dialog box template for the configuration dialog box must have the DLG_SCRNSAVECONFIGURE identifier.

A screen saver application should save its configuration settings in the CONTROL.INI file.

The dialog box procedure is used only if the default window class (WC_DIALOG) is used for the dialog box. The default class is used if no explicit class is given in the dialog box template. Although the dialog box procedure is similar to a window procedure, it must not call the DefWindowProc function to process unwanted messages. Unwanted messages are processed internally by the default dialog box procedure.

The ScreenSaverConfigureDialog function must be exported by including it in an EXPORTS statement in the application's module-definition (.DEF) file.

See Also

MakeProcInstance, RegisterDialogClasses