browserui/browser/BrowserAppInc/BrowserDialogsProviderBlocker.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:31:04 +0100
branchRCL_3
changeset 65 8e6fa1719340
parent 0 84ad3b177aa3
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201032 Kit: 201035

/*
* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:  Blocks dialog requests to the BrowserDialogsProvider if a
*               window is in the background. When the window comes to the 
*               foreground, it will be displayed.
*
*
*/

#ifndef __BROWSERDIALOGSPROVIDERBLOCKER_H
#define __BROWSERDIALOGSPROVIDERBLOCKER_H

// INCLUDES
#include "BrowserDialogsProviderProxy.h"
#include <e32base.h>

// FORWARD DECLARATIONS
class CBrowserWindowFocusNotifier;

// CLASS DEFINITION
class CBrowserDialogsProviderBlocker : public CActive
    {
    public:  // constructors

        /**
        * Create a CBrowserDialogsProviderBlocker object. Leaves on failure.
        * @param aDlg . Not owned.
        * @return A reference to the created instance of 
        * CBrowserDialogsProviderBlocker
        */
        static CBrowserDialogsProviderBlocker* NewLC(
                            CBrowserWindowFocusNotifier& aWinFocusNotifier );

    private:  // default c++, and 2nd phase constructor

        /**
        * Constructs this object
        * @param aDlg. Not owned.
        */
        CBrowserDialogsProviderBlocker( 
                            CBrowserWindowFocusNotifier& aWinFocusNotifier );

        /**
        * Performs second phase construction of this object
        */
        void ConstructL();

    public:

        /**
        * Destroy the object and release all memory objects
        */
        ~CBrowserDialogsProviderBlocker();

        /**
        * Start an asynchronous request.
        */
        void Start();

    protected: // from CActive

        /**
        * Cancel any outstanding requests
        */
        void DoCancel();

        /**
        * Handles object`s request completion event.
        */
        void RunL();

    private:

        /**
        * Indicates the completion status of a request made to a 
        * service provider.
        */
        //TRequestStatus iStatus;
        
        CActiveSchedulerWait            iWait;              // Asynchronous wait
        
        CBrowserWindowFocusNotifier&    iWinFocusNotifier;  // not owned
    };

#endif  // __BROWSERDIALOGSPROVIDERBLOCKER_H

// End of file