util/src/gui/s60framework/qs60maindocument.cpp
changeset 7 f7bc934e204c
equal deleted inserted replaced
3:41300fa6a67c 7:f7bc934e204c
       
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
       
     4 ** All rights reserved.
       
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
       
     6 **
       
     7 ** This file is part of the Symbian application wrapper of the Qt Toolkit.
       
     8 **
       
     9 ** $QT_BEGIN_LICENSE:LGPL$
       
    10 ** No Commercial Usage
       
    11 ** This file contains pre-release code and may not be distributed.
       
    12 ** You may use this file in accordance with the terms and conditions
       
    13 ** contained in the Technology Preview License Agreement accompanying
       
    14 ** this package.
       
    15 **
       
    16 ** GNU Lesser General Public License Usage
       
    17 ** Alternatively, this file may be used under the terms of the GNU Lesser
       
    18 ** General Public License version 2.1 as published by the Free Software
       
    19 ** Foundation and appearing in the file LICENSE.LGPL included in the
       
    20 ** packaging of this file.  Please review the following information to
       
    21 ** ensure the GNU Lesser General Public License version 2.1 requirements
       
    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
       
    23 **
       
    24 ** In addition, as a special exception, Nokia gives you certain additional
       
    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
       
    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
       
    27 **
       
    28 ** If you have questions regarding the use of this file, please contact
       
    29 ** Nokia at qt-info@nokia.com.
       
    30 **
       
    31 **
       
    32 **
       
    33 **
       
    34 **
       
    35 **
       
    36 **
       
    37 **
       
    38 ** $QT_END_LICENSE$
       
    39 **
       
    40 ****************************************************************************/
       
    41 
       
    42 #include "qs60mainappui.h"
       
    43 #include "qs60maindocument.h"
       
    44 
       
    45 #include <exception>
       
    46 
       
    47 QT_BEGIN_NAMESPACE
       
    48 
       
    49 /*!
       
    50   \class QS60MainDocument
       
    51   \since 4.6
       
    52   \brief The QS60MainDocument class is a helper class for S60 migration.
       
    53 
       
    54   \warning This class is provided only to get access to S60 specific
       
    55   functionality in the application framework classes. It is not
       
    56   portable. We strongly recommend against using it in new applications.
       
    57 
       
    58   The QS60MainDocument provides a helper class for use in migrating
       
    59   from existing S60 based applications to Qt based applications. It is
       
    60   used in the exact same way as the \c CAknDocument class from
       
    61   Symbian, but internally provides extensions used by Qt.
       
    62 
       
    63   When modifying old S60 applications that rely on implementing
       
    64   functions in \c CAknDocument, the class should be modified to
       
    65   inherit from this class instead of \c CAknDocument. Then the
       
    66   application can choose to override only certain functions.
       
    67 
       
    68   For more information on \c CAknDocument, please see the S60
       
    69   documentation.
       
    70 
       
    71   Unlike other Qt classes, QS60MainDocument behaves like an S60 class,
       
    72   and can throw Symbian leaves.
       
    73 
       
    74   \sa QS60MainApplication, QS60MainAppUi
       
    75  */
       
    76 
       
    77 /*!
       
    78  * \brief Constructs an instance of QS60MainDocument.
       
    79  *
       
    80  * \a mainApplication should contain a pointer to a QS60MainApplication instance.
       
    81  */
       
    82 QS60MainDocument::QS60MainDocument(CEikApplication& mainApplication)
       
    83     : CAknDocument(mainApplication)
       
    84 {
       
    85     // No implementation required
       
    86 }
       
    87 
       
    88 /*!
       
    89  * \brief Destroys the QS60MainDocument.
       
    90  */
       
    91 QS60MainDocument::~QS60MainDocument()
       
    92 {
       
    93     // No implementation required
       
    94 }
       
    95 
       
    96 /*!
       
    97  * \brief Creates an instance of QS60MainAppUi.
       
    98  *
       
    99  * \sa QS60MainAppUi
       
   100  */
       
   101 CEikAppUi *QS60MainDocument::CreateAppUiL()
       
   102 {
       
   103     // Create the application user interface, and return a pointer to it;
       
   104     // the framework takes ownership of this object
       
   105     return (static_cast <CEikAppUi*>(new(ELeave)QS60MainAppUi));
       
   106 }
       
   107 
       
   108 QT_END_NAMESPACE