GUIBaseContext :: doMessage - Process control message
The event handler allows reacting on a user control message. User control messages are submitted in order to inform the application about specific events.
The message passed from the user control is a string stored in the internal control area. In order to obtain the message submitted by the user control, one may call getMessage().
int32 .... ::doMessage { // osi fragment
switch ( getMessage() ) {
case "next" : nextElement(); break;
case "previous" : prevElement(); break;
case "end" : stopProcessing();break;
}
}
A return code -1 indicates, that the action was not executed and should be toggled to the next executing object.
A return code 0 indicates, that the function was terminated successfully.
All other return codes indicate an error.