clientside_message_handler

Client side event handler when an EO.Web control displays a message box.

Note: This is a prototype, not a function. You should provide a function that matches this prototype if you wish to handle the corresponding event on the client side. The prototype provides information about the arguments and return value of the function you provide.

Syntax
JavaScript
 clientside_message_handler(control, name, message, type, args)

Parameters

control
The Control that triggered this event.
name

A string message name. This parameter can have different values for different controls.

The following values are valid for a SpellChecker control:

Message Name Remark
"no_error" SpellChecker completed with no error.
"done" SpellChecker completed.

The following values are valid for an Editor control:

Message Name Remark
"find_nomatch"

The find dialog can not find any match of the text to search for.

args parameter is an array with a single string element. The single element contains the text to search for.

"msword_confirm"

The editor asks user to confirm whether Word formatting information should be removed.

The following values are valid for a FileExplorer control:

Message Name Remark
"demo_mode" The feature is disabled in demo mode.
"invalid_file_name" The file name is invalid.
"confirm_delete_folder" Ask user to confirm before deleting a folder.
"confirm_delete_file" Ask user to confirm before deleting a file.
"server_call_failed" The call to the server failed. This may not be a problem for the circumstance. For example, when two users are competing to rename a file, one of them may succeed and the other fails.
message
The default message.
type
Message type, can be "confirm" or "alert".
args
An array of message arguments. This parameter is null for most messages. When this message is not null, message parameter contains the format string that can be used to format these arguments. For example, when the search dialog for an Editor control fails to find a match, the message parameter contains "Can not find '{0}'.", where this parameter contains any array with a single element that is the word to be searched for.
Remarks

This event handler is often used to localize/customize the default message text.

See Also