company logo

ControlContext :: submitMessage - Submit message to user control

The function sends a text message to a user control. When the control associated with the control context is not a user control, the function does nothing. In order to obtain messages in a user control, the user control has to re-implement the UserControl::message() function.

Messages (commands) processed by a user control are defined for each user control separately. Typically, a message contains a command and optional parameters:

    command[:parm1;parm2...]

Parameters are separated by semicolon. When a parameter contains a semicolon, it has to be quoted ("..."). Quotes at beginning and end of a parameter string are removed.

//..fragment

  field('user_control').setProperty(phVideo);

  field('user_control').message('start animation:animation file');

Implementation details

ControlContext  :: submitMessage ( odaba::String &sText )
  • sText - Text string