ScreenSaverConfigureDialog
The ScreenSaverConfigureDialog
function receives messages sent to a screen saver s configuration dialog box. A
screen saver that allows user configuration must support this function.
BOOL ScreenSaverConfigureDialog(
|
HWND hDlg, |
// handle of dialog
box |
|
UINT
message, |
// message |
|
WPARAM wParam, |
// first message
parameter |
|
LPARAM lParam |
// second message
parameter |
|
); |
|
Parameters
hDlg
Identifies
the configuration dialog box.
message
Specifies the
message.
wParam
Specifies
additional message-specific information.
lParam
Specifies
additional message-specific information.
Return Values
If the
function processes the message, the return value is TRUE; otherwise, it is
FALSE, except in response to a WM_INITDIALOG message. In response to a
WM_INITDIALOG message, ScreenSaverConfigureDialog should return FALSE if
it calls the SetFocus
function to set the keyboard focus to one of the controls in the dialog box.
Otherwise, the function should return TRUE, in which case the system sets the
keyboard focus to the first control in the dialog box that can be given the
focus.
Remarks
The dialog
box template for the configuration dialog box must have the DLG_SCRNSAVECONFIGURE
identifier.
The dialog
box procedure is used only if the application specifies the default window
class (WC_DIALOG) for the dialog box. The application uses the default class 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 the EXPORTS statement in
the application s module-definition (.DEF) file.
See Also