1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task id="GUID-FC46AA09-3E04-426B-BAC0-A992EA1AE0B6" xml:lang="en"><title>Write

    13 a conversion observer</title><prolog><metadata><keywords/></metadata></prolog><taskbody>

    14 <context>       <p>Converter clients can supply a converter observer object

    15 by implementing the <codeph>MConverterUiObserver</codeph> interface. The object

    16 is passed to the converter's <codeph>CConverterBase2::ConvertL()</codeph>, <codeph>CConverterBase2::ConvertObjectL()</codeph>, <codeph>CConverterBase2::ConvertAL()</codeph> or <codeph>CConverterBase2::ConvertObjectAL()</codeph> function. It is used

    17 for reporting on the progress of multi-step conversions and for requesting

    18 a password from the client when the file being converted from is password-protected.</p><p>The

    19 following functions can be implemented:</p><ul>

    20 <li><p><codeph>virtual void MaxSteps(TInt aMax, TInt aObject)=0;</codeph> to

    21 get the maximum number of steps that the conversion operation can take. </p></li>

    22 <li><p><codeph>virtual TInt Result(TInt aResult, TInt aObject)=0;</codeph> to

    23 take some action following an error in the conversion.</p></li>

    24 <li><p><codeph>virtual HBufC* QueryPasswordL(const TDesC&amp; aClue)=0;</codeph> to

    25 request a password from the user in order to access the data.</p></li>

    26 </ul></context>

    27 </taskbody></task>