mpviewplugins/mpdetailsviewplugin/src/mpdetailsviewplugin.cpp
author hgs
Fri, 09 Jul 2010 16:27:03 -0500
changeset 43 0f32e550d9d8
parent 20 82baf59ce8dd
permissions -rw-r--r--
201027

/*
* Copyright (c) 2009 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: Plugin interface for Music Player details view.
*
*/

#include <xqplugin.h>

#include "mpdetailsviewplugin.h"
#include "mpdetailsview.h"
#include "mptrace.h"

/*!
    \class MpDetailsViewPlugin
    \brief Plugin interface for Music Player details view.

    Details view plugin provides interface to the details view
    beyond a plugin interface for application and view separation.
*/

/*!
    \fn void command( int command )

    This signal is emitted when the view issues a \a command to the
    application such as request to switch to a different view.
 */

/*!
 Constructs the details view plugin.
 */
MpDetailsViewPlugin::MpDetailsViewPlugin()
    : mView(0),
      mState(NullView)
{
    TX_LOG
}

/*!
 Destructs the details view plugin.
 */
MpDetailsViewPlugin::~MpDetailsViewPlugin()
{
    TX_LOG
}

/*!
 Creates the details view.
 */
void MpDetailsViewPlugin::createView()
{
    TX_ENTRY
    if ( mState == NullView ) {
        mView = new MpDetailsView();
        connect( mView, SIGNAL( command( int ) ), this, SIGNAL( command( int ) ) );
        mState = Created;
    }
    TX_EXIT
}

/*!
 Destroys the details view.
 */
void MpDetailsViewPlugin::destroyView()
{
    TX_ENTRY
    if ( mState != NullView ) {
        delete mView;
        mView = NULL;
        mState = NullView;
    }
    TX_EXIT
}

/*!
 Activates the details view. View initialization is done very first time.
 */
void MpDetailsViewPlugin::activateView()
{
    TX_ENTRY_ARGS( "mState=" << mState );
    switch ( mState ) {
    case Created:
        mView->initializeView();
        mView->activateView();
        mState = Activated;
        break;
    case Initialized:
        mView->activateView();
        mState = Activated;
        break;
    default:
        // Ignore
        break;
    }
    TX_EXIT
}

/*!
 Deactivates the details view.
 */
void MpDetailsViewPlugin::deactivateView()
{
    TX_ENTRY
    if ( mState == Activated ) {
        mView->deactivateView();
        mState = Initialized;
    }
    TX_EXIT
}

/*!
 Returns pointer to QGraphicsWidget, which is the details view.
 The returned pointer is 0, if it is not created first.

 \sa createView()
 */
QGraphicsWidget* MpDetailsViewPlugin::getView()
{
    TX_LOG
    return mView;
}

/*!
 Slot to be called when application orientation changes.

 \reimp
 */
void MpDetailsViewPlugin::orientationChange( Qt::Orientation orientation )
{
    TX_LOG
    Q_UNUSED( orientation );
}

/*!
 Slot to handle back command from softkey.

 \reimp
 */
void MpDetailsViewPlugin::back()
{
    //do nothing, softkey is handledinternally by the view.
    TX_LOG
}

XQ_EXPORT_PLUGIN2( mpdetailsviewplugin, MpDetailsViewPlugin );