PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Customizing the display of messages
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
HOnServerCall (Function)
In french: HSurAppelServeur
HFSQL Client/ServerAvailable only with this kind of connection
Customizes the management of message display on the client computer and the management of disconnection from a client computer.
Reminder: Sending a message to the client computer is performed by HSendMessageToClient. The disconnection of a client computer is performed by HDisconnectClient.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 20 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
New in version 20
iPhone/iPad This function is now available for iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
iPhone/iPad This function is now available for iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
WINDEVLinux This function is now available for WINDEV applications in Linux.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Versions 22 and later
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
WINDEVJava This function is now available for Java applications.
New in version 22
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
WINDEVJava This function is now available for Java applications.
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
WINDEVJava This function is now available for Java applications.
Example
// Define the Client messages
// The ClientMessage procedure is called
// whenever HSendMessageToClient is used
HOnServerCall(hMessage, "ClientMessage")
// ClientMessage procedure
PROCEDURE ClientMessage(Type, MessageToDisplay, DurationMessageDisplay)
IF Type = hMessage THEN
Open(WIN_MyWin, MessageToDisplay)
END
Syntax
<Result> = HOnServerCall(<Type of message> [, <WLanguage procedure> [, <Options>]])
<Result>: Boolean
  • True if the operation was successfully performed,
  • False otherwise. HError returns more details about the problem.
<Type of message>: Integer constant
Type of message to configure.
hDisconnectionConfigure the disconnection message.
hMessageConfigure the information message
<WLanguage procedure>: Procedure name
Procedure that must be called when a <Type of message> message is displayed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Message type>, <Message>, <Display duration>)
If this parameter is not specified, the message will be displayed in the default window.
If this parameter is equal to an empty string (""), the automatic management will be disabled. In case of a disconnection, the connection will be closed by the server. An error will be displayed during the next access to a data file.
<Options>: Integer constant
Versions 19 and later
Option for running the procedure:
Versions 19 and later
hSecondaryThread
New in version 19
hSecondaryThread
hSecondaryThread		The procedure is run in a secondary thread.

If this option is not specified, the procedure is run in the main thread.
New in version 19
Option for running the procedure:
Versions 19 and later
hSecondaryThread
New in version 19
hSecondaryThread
hSecondaryThread		The procedure is run in a secondary thread.

If this option is not specified, the procedure is run in the main thread.
Option for running the procedure:
Versions 19 and later
hSecondaryThread
New in version 19
hSecondaryThread
hSecondaryThread		The procedure is run in a secondary thread.

If this option is not specified, the procedure is run in the main thread.
Remarks

Customizing the display of messages

All the actions are allowed in the WLanguage procedure.
In case of a disconnection message, the disconnection will be performed after the duration specified in HDisconnectClient (regardless of the actions performed in the procedure).

Miscellaneous

  • HOnServerCall must be used in the main thread.
  • HOnServerCall is global to the entire application, including the components run. If HOnServerCall is used in a component, it will be enabled for the host application (the last call to HOnServerCall is taken into account)
  • Versions 24 and later
    HOnServerCall can be used in a Windows service.
    New in version 24
    HOnServerCall can be used in a Windows service.
    HOnServerCall can be used in a Windows service.
Business / UI classification: Business Logic
Component: wd270hf.dll
See also
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment