company logo

GUIBaseContext :: getMessage - Get Control message

The function should be called in the doMessage() handler in order to obtain the submitted message from the control. The message is an ASCII string passed from the control in order to request data or for any other reason. Message structure and content depend on the control type.

Messages are typically submitted from user controls, which are not able to emit appropriate system events.

int32 .... ::doMessage { // osi fragment

  switch ( getMessage() ) {

    case "next"     : nextElement();   break;

    case "previous" : prevElement();   break;

    case "end"      : stopProcessing();break;

  }

}

Return value:  Resource or entity name ( odaba::String & )

The name refers to a design or GUI resource.

Implementation details

odaba::String GUIBaseContext  :: getMessage (  )