Sethotpadnotification - Fujitsu Stylistic 2300 Technical Reference Manual

Hotpad notification is performed using one of the following methods. The parameters passed to the
SetHotpadNotification function determine which notification method is used.
• A notification message sent to the window procedure of the application.
• A call-back function.

SetHotpadNotification

The SetHotpadNotification function enables hotpad notification. Applications which are to receive
notification of hotpad events must call this function once to enable hotpad notification. A prototype of
this function is shown below:
int SetHotpadNotification ( HWND WindowHandle , UINT MessageID , FARPROC CallbackPointer )
If a hotpad event is to generate a notification message, the WindowHandle and MessageID parameters are
required. If a hotpad event is to generate a call-back function call, the CallbackPointer parameter is
required. Details on these parameters are as follows:
Parameter
WindowHandle
MessageID
CallbackPointer
Return values for this function are as follows:
Return Value
Positive nonzero integer
0
-1
-2
-3
9-2 Programmable Hotpad Libraries for 16-bit Windows Applications
Description
Handle to the application window which will receive hotpad notification
messages.
If this parameter is NULL, the CallbackPointer parameter must be a valid
call-back function address.
Message ID of the notification message that will be sent to the application
window when a hotpad event occurs.
If this parameter is NULL, the CallbackPointer parameter must be a valid
call-back function address.
Pointer to the call-back function in the application that will receive hotpad
notification. See "Call-Back Function" on page 9-3 for information on how to
declare the callback function.
If the WindowHandle parameter is not NULL, this parameter is ignored and
hotpad notification is sent via a notification message.
If this parameter is NULL, the WindowHandle and MessageID parameters
must be valid.
Description
Hotpad notification ID. Returned on success.
The library assigns a unique hotpad notification ID number for each
occurrence of the SetHotpadNotification function. Your application must
pass this ID number when hotpad notification is disabled using the
KillHotpadNotification function.
Memory allocation failure.
WindowHandle parameter not valid.
Could not allocate system timer.
CallbackPointer parameter not valid.
Microsoft Corp. Exhibit 1020