/*

* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* which accompanies this distribution, and is available

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  

*     Defines sdk extended capabilities

*

*/

#ifndef __EXTENDEDMTMIDS_HRH__

#define __EXTENDEDMTMIDS_HRH__

/**

 * UIDs for quering capabilities from MTMs (CBaseMtmUiData)

 *

 * How to use:

 *

 * @code

 * #include <ExtendedMTMIDS.hrh>

 *

 * TInt CMyMtmUiData::QueryCapability( TUid aFunctionId, TInt& aResponse ) const

 *     {

 *     ...

 *     switch ( aFunctionId.iUid )

 *         {

 *         // MTM supports linked attachments:

 *         case KUidMsvMtmQuerySupportLinks:

 *             {

 *             aResponse = ETrue;

 *             return KErrNone;

 *             }

 *         // MTM supports service validation:

 *         case KUidMsvMtmQuerySupportValidateService:

 *             {

 *             aResponse = ETrue;

 *             return KErrNone;

 *             }

 *         // MTM supports editor:

 *         case KUidMsvMtmQuerySupportEditor:

 *             {

 *             aResponse = ETrue;

 *             return KErrNone;

 *             }

 *         ...

 *         } 

 *     ...

 *     }

 * @endcode

 *

 */

#define KUidMsvMtmQuerySupportLinks                 0x100059D4 // response true/false

#define KUidMsvMtmQuerySupportValidateService       0x10005A11 // response true/false

#define KUidMsvMtmQuerySupportEditor                0x101FD692 // response true/false

/**

 * Function ids for custom MTM commands

 *

 * For MTM specific command ids use consecutive numbering starting from

 * KMtmUiFirstFreeMtmSpecificFunction.

 *

 * How to use:

 *

 * Define custom commands in resources:

 *

 * @code

 *

 * RESOURCE MTUD_FUNCTION_ARRAY r_my_mtm_function_array

 *     {

 *     functions =

 *         {

 *         // Settings to be shown in Message Center

 *         MTUD_FUNCTION 

 *             {

 *             functiontext = "My settings";

 *             command = KMtmUiMceSettings;

 *             flags = EMtudCommandTransferSend;

 *             } 

 *         // Settings wizard to be shown in Email Wizard UI

 *         MTUD_FUNCTION 

 *             {

 *             functiontext = "My wizard";

 *             command = KMtmUiFunctionSettingsWizard;

 *             flags = EMtudCommandTransferSend;

 *             }

 *          ...

 *          }

 *     }

 *

 * @endcode

 *

 * Implement functionality in the UI MTM (CBaseMtmUi)

 *

 * @code

 * void CMyMtmUi::InvokeSyncFunctionL( TInt aFunctionId,

 *                                     const CMsvEntrySelection& aSelection,

 *                                     TDes8& aParameter)

 *     {

 *     switch ( aFunctionId )

 *         {

 *         case KMtmUiFunctionValidateService:

 *             {

 *             // Validate service

 *             ...

 *             // Service valid

 *             TPckgBuf<TInt> resultPackage( KErrNone );

 *             aParameter.Copy( resultPackage );

 *             break;

 *             }

 *         case KMtmUiFunctionSettingsWizard:

 *             {

 *             // Show settings wizard

 *             ...

 *             // Wizard completed successfully

 *             TPckgBuf<TInt> resultPackage( 1 );

 *             aParameter.Copy( resultPackage );

 *             break;

 *             }

 *         }

 *     }

 *

 * @endcode

 *

 * "KMtmUiMceSettings" command is handled in a special way. The MTUD_FUNCTION is only

 * used for registration purposes. The actual settings dialog is launched by 

 * calling "CBaseMtmUi::EditL" for the service entry of the corresponding MTM.

 *

 * @code

 *

 * CMsvOperation* CMyMtmUi::EditL( TRequestStatus& aStatus )

 *     {

 *     switch ( iBaseMtm.Entry().Entry().iType.iUid )

 *         {

 *         case KUidMsvServiceEntryValue:

 *             {

 *             // Open settings dialog

 *             return OpenServiceSettingsDialogOperationL( aStatus );

 *             }

 *         ...

 *         }

 *     }

 *

 * @endcode

 */

#define KMtmUiMceSettings                           0x00203004

#define KMtmUiFunctionValidateService               0x00203006

#define KMtmUiFunctionSettingsWizard                0x00203013

#define KMtmUiFirstFreeMtmSpecificFunction          0x00300000

#endif // __EXTENDEDMTMIDS_HRH__

// End of file