Overview

Purpose

The File Converter Framework converts data +from one format to another format. For example, HTML files can be converted +to Symbian word documents.

Architecture

The File Converter Framework +architecture provides a framework for ECOM plug-ins, called converters, that +can convert data between different formats. When an application requests to +convert data from one format to another format, the framework checks the list +of available converters. If there is a converter that can do the conversion, +then the framework assigns the request to that converter.

The following +diagram shows the File converter framework architecture.

+ +

API summary + + + +API +Description + + + + +

CCnaConverter

A class that contains the properties of a converter. These are a +UID and the data types that the converter supports.

+ + +

CConverterBase

A class that provides an interface to access the converters.

+ + +

CConverterBase2

A base class for converters.

+ + +

CCnaConverterList

A class that provides a list of available converters. It allows +clients to search for and obtain converters for specific source and target +data types.

+ + +

CCnaConvInfoFileReader2

A class that encapsulates a collection of converter properties, CCnaConverter, +read from a converter information .rsc file.

+ + +

CMimeInfo

A class that contains the localized names for a data type.

+ + +

MConverterUiObserver

An interface implemented by the client of a conversion operation +to observe conversion progress.

+ + + +

Typical uses

Using a converter

File +Converter Framework provides APIs to list and search for converters. It also +provides an observer interface through which the progress and success or failure +of the conversion can be reported. For more information, see Using +a converter.

Writing a converter

File Converter +Framework specifies a plug-in interface for converters. For more information, +see Writing a Converter.