1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  stub hbdialog

    15 * 

    16 */

    17 

    18 #ifndef HBDIALOG_H

    19 #define HBDIALOG_H

    20 

    21 #include <QObject>

    22 #include <qsize.h>

    23 #include "hbwidget.h"

    24 class QGraphicsItem;

    25 class QGraphicsWidget;

    26 class HbAction;

    27 

    28 class HbDialog :  public HbWidget

    29 {

    30    Q_OBJECT

    31    

    32 signals:

    33 

    34     /**

    35      * emitted from open -method 

    36      */

    37     void finished(HbAction*); 

    38    

    39 public:

    40     

    41     enum DefaultTimeout

    42     {

    43        NoTimeout,

    44        ConfirmationNoteTimeout,

    45        StandardTimeout,

    46        ContextMenuTimeout,

    47     };

    48 

    49     enum DismissPolicy

    50     {

    51        NoDismiss   = 0,

    52        TapInside   = 1,

    53        TapOutside  = 2,

    54        TapAnywhere = TapInside | TapOutside

    55     };

    56     

    57     /**

    58      * contructor

    59      */

    60     HbDialog(QGraphicsItem *parent=0);

    61     

    62     /**

    63      * destructor

    64      */

    65     ~HbDialog();

    66     

    67 public slots:

    68     

    69     /**

    70      * emits finished -signal with mPrimaryAction if execReturnPrimary is true. 

    71      */

    72     void open( QObject* receiver = 0, const char* member = 0 );

    73     

    74 public:

    75     

    76     /**

    77      * sets mDismissPolicy

    78      */

    79     void setDismissPolicy(HbDialog::DismissPolicy dismissPolicy);

    80     

    81     /**

    82      * sets mTimeout

    83      */

    84     void setTimeout(HbDialog::DefaultTimeout timeout);

    85     

    86     /**

    87      * sets mHeadingWidget; 

    88      */

    89     void setHeadingWidget(QGraphicsWidget *headingWidget);

    90 

    91     /**

    92      * sets mContentWidget

    93      */

    94     void setContentWidget(QGraphicsWidget *contentWidget);

    95 

    96     /**

    97      * sets mPrimaryAction

    98      */

    99     void setPrimaryAction(HbAction *action);

   100     

   101     /**

   102      * add action into actions -list

   103      */

   104     void addAction(HbAction *action);

   105     

   106     /**

   107      * gets mPrimaryAction;

   108      */

   109     HbAction* primaryAction();

   110 

   111     /**

   112      * sets mSecondaryAction

   113      */

   114     void setSecondaryAction(HbAction *action);

   115     

   116     /**

   117      * gets mSecondaryAction;

   118      */

   119     HbAction* secondaryAction();

   120            

   121     /**

   122      * sets mMinSize

   123      */

   124     void setMinimumSize(QSize size);

   125     

   126     /**

   127      * sets mMaxSize

   128      */

   129     void setMaximumSize(QSize size); 

   130     

   131     /**

   132      * returns mPrimaryAction if execReturnPrimary is true.

   133      */

   134     HbAction* exec();

   135         

   136     /**

   137      * stubbed member

   138      */

   139     QGraphicsWidget *mHeadingWidget;

   140     

   141     /**

   142      * stubbed member

   143      */

   144     QGraphicsWidget *mContentWidget;

   145     

   146     /**

   147      * stubbed member

   148      */

   149     HbAction *mPrimaryAction;

   150     

   151     /**

   152      * stubbed member

   153      */

   154     HbAction *mSecondaryAction;

   155     

   156     /**

   157      * stubbed member

   158      */

   159     QSize mMinSize;

   160     

   161     /**

   162      * stubbed member

   163      */

   164     QSize mMaxSize;

   165     

   166     /**

   167      * stubbed member

   168      */

   169     HbDialog::DefaultTimeout mTimeout;

   170     

   171     /**

   172      * stubbed member

   173      */

   174     HbDialog::DismissPolicy mDismissPolicy;

   175     

   176     /**

   177      * actions other tham primary or secondary

   178      */

   179     QList<HbAction*> mActions;

   180        

   181     /**

   182      * address of current instance zeroed during destcructor

   183      * this is for making sure object is removed correctly

   184      */

   185     static HbDialog *currentInstance;

   186         

   187     /**

   188      * if true, exec returns mPrimaryAction

   189      */

   190     static bool execReturnPrimary;

   191     

   192     /**

   193      * if true, primaryAction() -method returns null

   194      */

   195     static bool primaryReturnNull;   

   196     

   197     /**

   198      * if true, secondaryAction() -method returns null

   199      */

   200     static bool secondaryReturnNull;

   201 };

   202 

   203 #endif