MessageUser() [2/2]

virtual void drama::MessageHandler::MessageUser ( const std::string &  text ) const

virtualinherited

Use DRAMA to send a message to the user.

The supplied text is send to the user using, see MsgOut(). Normally this appears the user interface.

If the message contains line feed characters (\n), then they are used to break the message up.

Note

Only valid if invoked in the context of MessageReceived() being invoked (i.e. you are within an action implementation) or is invoked via a MessageReceived() or sub-class object.

Deprecated:

Use the MessageUserF() interface. That matches the more modern C++ style and is safer.

See also

MessageUserF() for formatted output.

SdsListToUser() for output of an SDS structure

MessageUserStreamBuf to implement a stream buffer that outputs using MessageUser().

Parameters

text	The string to output to the user.

Reimplemented in drama::thread::TAction.

Referenced by drama::MessageHandler::MessageUser(), drama::thread::TAction::MessageUser(), drama::MessageHandler::MessageUserF(), and drama::thread::TAction::MessageUserF().