C++ Syntax

bool

MKI_DialogEnterIdle(

HWND f_hWindow,

WPARAM f_wParam,

LPARAM f_lParam );

Handles the WM_ENTERIDLE message a dialog window, allowing the user to press F1 in order to get help on the current dialog window.

Parameters

Window

[HWND] Handle of the dialog window that received the WM_ENTERIDLE message.

wParam

[WPARAM] First parameter that was passed with the WM_ENTERIDLE message.

lParam

[LPARAM] Second parameter that was passed with the WM_ENTERIDLE message.

Return Value

Returns true if the WM_ENTERIDLE message was processed, false if not. This value should be returned from the dialog window's callback procedure to inform the system whether or not this message was processed.

Comment

This procedure should be placed in the WM_ENTERIDLE case of all dialog windows' main message switches:

INT_PTR CALLBACK

DialogProc( HWND f_hDlg, UINT f_unMessage, WPARAM f_wParam, LPARAM f_lParam )

{

switch( f_unMessage )

{

...

case WM_ENTERIDLE:

return( MKI_DialogEnterIdle( f_hDlg, f_wParam, f_lParam ) );

default:

if( f_unMessage == WM_HELP )

{

MKI_DialogHelpTopic( hGlobalWnd, ... );

return( 1 );

}

break;

}

return( 0 );

}