PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Customization
  • Use conditions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
HSendMessageToClient (Function)
In French: HEnvoieMessageVersClient
HFSQL Client/ServerAvailable only with this kind of connection
Displays a message on the client computers. The affected client computers are the computers listed in the HClient structure.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
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.
Versions 20 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 20
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVWEBDEV - Server code This function is now available to send a message to the users of a HFSQL cluster.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVWEBDEV - Server code This function is now available to send a message to the users of a HFSQL cluster.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVWEBDEV - Server code This function is now available to send a message to the users of a HFSQL cluster.
Versions 22 and later
Android Widget This function is now available in Android Widget mode.
Java This function is now available for the Java applications.
Android This function is now available for the Android applications.
New in version 22
Android Widget This function is now available in Android Widget mode.
Java This function is now available for the Java applications.
Android This function is now available for the Android applications.
Android Widget This function is now available in Android Widget mode.
Java This function is now available for the Java applications.
Android This function is now available for the Android applications.
Example
// Message to all users of "MAILBOX" database
HClient.Database = "MAILBOX"
HSendMessageToClient("MyConnection", "Caution: You will be disconnected soon", 300)
// Message to the "Admin" user of "MyDatabase" database
HClient.Database = "MyDatabase"
HClient.Login = "Admin"
HSendMessageToClient("MyConnection", "Test for sending messages", 15)
// Message to all applications accessing Client.fic
// found in "MyDatabase"
HClient.Database = "MyDatabase"
HClient.File = "Customer.fic"
HSendMessageToClient("MyConnection", "You are using the Client file", 300)
// Message to all applications run on "Computer1"
//  that use the "Admin" login
HClient.Computer = "Computer1"
HClient.Login = "Admin"
HSendMessageToClient("MyConnection", "Caution: You will be disconnected soon", 300)
Syntax
<Result> = HSendMessageToClient(<Connection Name> , <Message> , <Display Duration>)
<Result>: Boolean
  • True if the operation was performed,
  • False if a problem occurred.
HSendMessageToClient is a locking function while the message is being sent to the server. The application continues to run once the message is received by the server.
<Connection Name>: Character string (with or without quotes)
Name of connection to use. This connection was defined in the data model editor, or by HDescribeConnection or HOpenConnection.
<Message>: Character string (with quotes)
Message that will be displayed on the client computer.
<Display Duration>: Integer ou Duration
Display duration of message (in seconds). This parameter can correspond to:
  • an integer corresponding to the number of seconds,
  • a Duration variable,
  • Versions 23 and later
    the direct indication of duration (1 s for example).
    New in version 23
    the direct indication of duration (1 s for example).
    the direct indication of duration (1 s for example).
Remarks

Customization

HOnServerCall is used to customize the management of message display on the client computer.

Use conditions

  • To use this function, you must have:
    • the "Rights to send messages to the client computers" (hRightsSendMessageToClient constant in HModifyServerRights).
    • the "Rights to see the users and groups" (hRightsSeeUser constant in HModifyServerRights).
  • The message will be sent to the users that the client calling the function is allowed to see.
  • Versions 21 and later
    This function can be used to send a message to all the users of a HFSQL cluster.
    New in version 21
    This function can be used to send a message to all the users of a HFSQL cluster.
    This function can be used to send a message to all the users of a HFSQL cluster.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230hf.dll
Windows Mobile wp230hf.dll
Java wd230java.jar
Linux wd230hf.so
Android wd230android.jar
See also
Minimum required version
  • Version 10
This page is also available for…
Comments
Mandar Mensagem Usuarios
HClient.Database = "matos"
HSendMessageToClient(Matos_hyperfil_server, EDT_OBSERVACAO, 15)

// blog com vídeo e exemplo


http://windevdesenvolvimento.blogspot.com.br/2017/07/aula-1212-windev-hyperfile-28.html

https://www.youtube.com/watch?v=Krjl9RltwWQ


De matos
Jul. 16 2017