User Interface MTM implementation

Example Code

Click on the following link to download the example:.TextMTM.zip

Click: browse to view the example code.

The files reproduced here are the main files contained in the examples directory. Some extra files may be needed to run the examples, and these will be found in the appropriate examples directory.

Class summary

• CBaseMtmUi

• TMsvId

• CMsvOperation

• CEikFileSaveAsDialog

• CEikDialog

Description

The txtu project demonstrates a User Interface MTM. The central class is CTextMtmUi, derived from the User Interface MTM base class CBaseMtmUi.

Note that the txtu project has dependencies on some GUI components that might not be present on all SDKs.

txtu implements the following MTM functionality:

Basic functions for messages

Create(): this creates a new local message in the Draft folder, with description field set to "New Text", and then invokes edit.

Edit(): no UI for editing and viewing text messages is implemented. A simple stub is provided that simply appends the text "Edited document" to the message and puts up an information message.

If an edit command is invoked on a remote message entry (an entry under a Text service entry), the MTM offers to copy it to the local Inbox first. This is performed by class CEditRemoteOperation. and dialog resource r_dialog_refuse_edit_remote_message.

Open() and View(): these functions for a message context simply calls the edit function.

CopyToL(), MoveToL(), CopyFromL(), MoveFromL() and DeleteL(): simple implementations of these functions are provided that use the CMsvEntry copy, move and delete functions. These commands are passed to the Message Server, which then passes them on to the Server-side Text MTM.

ReplyL() and ForwardL(): there is no UI support for message replies and forwarding.

Basic functions for services

Create() and Edit(): when requested to create a new Text service entry, a dialog pops up allowing the user to specify the folder associated with the service. This is performed by class CTextMtmEditServiceDialog and resource r_dialog_service_settings. The service entry can then be edited later on, to change the folder.

After the service entry is created or changed, an automatic refresh will be triggered.

MTM-specific operations

The following MTM-specific operations are accepted:

• Refresh: this command refreshes the currently highlighted service entry. It calls the MTM-specific operations provided by the Client-side MTM to do this.

• Export text to file: exports the text contained in a text message to a file. This is performed by DoExportTextFromMessageL().