/*
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* 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