devmngt_plat/default_app_client_api/inc/das_client.h
branchRCL_3
changeset 13 90fe62538f66
parent 12 3fec62e6e7fc
child 14 5f281e37a2f5
--- a/devmngt_plat/default_app_client_api/inc/das_client.h	Thu Aug 19 09:55:50 2010 +0300
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,168 +0,0 @@
-/*
-* Copyright (c) 2005-2006 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:  Client interface to ask for setting the default application
-*
-*/
-
-
-
-#ifndef C_DEFAULTAPPCLIENT_H
-#define C_DEFAULTAPPCLIENT_H
-
-#include <e32def.h>
-#include <e32base.h>
-#include <AknServerApp.h>
-
-class RDefaultAppService; 
- 
- 
-/**
- *  Client API for setting the default application.
- *
- *  This class defines the API that applications should use to trigger the launch of the
- *  Default Application Server, that asks the user to select default applications for those
- *  Service & MIME pairs for which the client application is a candidate.
- *
- *  A client application should first instantiate the service, using eithe NewL() or NewLC()
- *  The client application can check first if the sercive is available in the system (by using 
- *  the ServiceAvailable() function. The client application may also check if there is 
- *  anything to display (if there is any Service & MIME that the client application supports for 
- *  which there is at least another application supporting the pair). If there is no such pair,
- *  then launching the server would display an empty list). This checking is performed using the 
- *  PairsToDisplayL() function. 
- *
- *  After the above checkings are done, the client application can ask the server to change
- *  defaults by calling the ChangeDefaultsL() function. 
- *    
- *
- *  @lib defaultappclient.dll
- *  @since S60 v5.0
- */
-class CDefaultAppClient : public CBase 
-    {
-
-public:
-
-    /**  flags used to modify the service behaviour */
-    enum TFlags
-        {
-        EFlagNoObserver=1,
-        EFlagReserved1=2,
-        EFlagReserved2=4
-        };
-
-    /**
-     * Symbian OS two-phased constructor
-     * @return
-     */
-    IMPORT_C static CDefaultAppClient* NewL(MAknServerAppExitObserver* aObserver);
-
-    /**
-     * Symbian OS two-phased constructor
-     * @return
-     */
-    IMPORT_C static CDefaultAppClient* NewLC(MAknServerAppExitObserver* aObserver);
-
-    /**
-     * Destructor.
-     */
-    IMPORT_C virtual ~CDefaultAppClient();
-
-    /**
-     * Function to check if a server is present in the system. If the
-     * server is present, the subsequent functions should not fail due
-     * to server unavailability.
-     *
-     * @since S60 v5.0
-     * @return ETrue or EFalse, depending service/server availability
-     */
-    IMPORT_C static TBool ServiceAvailable( TInt& aErrorCode );
-    
-    /**
-     * Function to check the number of Service & MIME pairs the server would display if the 
-     * ChangeDefaultsL() would be called. The purpose of this function
-     * is to allow the client application not to display an entry for starting the server, in the 
-     * Options menu, in case the Server's list of Service & MIME pairs is empty.
-     * 
-     * Please note that the function may return a higher number than the actual number
-     * of pairs, because it does not check for MIMEs with System priority (that would not be 
-     * displayed).
-     *
-     * @since S60 v5.0
-     * @return the number of Service & MIME pairs the server would display
-     */
-    IMPORT_C TInt PairsToDisplayL();
-    
-    /**
-     * This function launches the server, as a chained application. The client application will not be
-     * available to the user until the server does not exit.
-     * When the server exits, the client application gains control again. The observer (if specified 
-     * during instantiation (NewL) is notified that the server has exited.
-     *
-     * @since S60 v5.0
-     * @param aFlags service flags 
-     */
-    IMPORT_C void ChangeDefaultsL( TInt aFlags = 0 );
-    
-
-private:
-
-    /**
-     * C++ default constructor.
-     */
-    CDefaultAppClient();
-
-    /**
-     * Symbian constructor.
-     */
-    void ConstructL( MAknServerAppExitObserver* aObserver );
-    
-    /**
-     * This function finds out the uid of the Default Application Server 
-     * (the application registered to handle the DefaultApp service)
-     *
-     * @since S60 v5.0
-     * @param aServerAppUid If parameter is non-NULL, it returns the Uid of the server there
-     */
-    static void GetServiceParamsL( TUid* aServerAppUid); 
-
-private: // data
-
-    /**
-     * The UID of the server application (we discover the server)
-     */
-    TUid iServerAppUid;
-
-    /**
-     * Pointer to the service class.
-     * Own.
-     */
-    RDefaultAppService *iService; 
-    
-    /**
-     * Pointer to the Observer to call after the operation initiated by
-     * ChangeDefaultsAsyncL() has finished.
-     * Not Owned.
-     */
-    MAknServerAppExitObserver* iObserver;
-    
-    /**
-     * Monitor object that calls the iObserver when the server has exited.
-     * Owned.
-     */
-    CApaServerAppExitMonitor* iMonitor;
-    
-    };
-
-#endif // C_DEFAULTAPPCLIENT_H