59     \brief HbPopup is a base class for different popups in Hb library.

    59     \brief The HbPopup class defines a set of properties that control the behavior of 

    60 

    60     the many dialog and popup classes that derive from it. 

    61     Popup is a widget that is displayed above other widgets in the view.

    61     

    62 

    62     Objects of classes derived from %HbPopup are called \b popups. Typically they

    63     Lastly shown popup is always positioned in Z order on the the top

    63     are displayed above other objects within the view, at the highest z-order. The %HbPopup

    64     of already visible popups.  

    64     class simply defines a frame with a number of properties. If you want to create an

    65 

    65     application dialog with a heading, content and a toolbar, use the HbDialog class (which

    66     A popup can be permanent or automatically dismissed after a

    66     is derived from %HbPopup) or one of its convenience subclasses.

    67     time-out.  Modal popups interrupt any other user interaction

    67     

    68     outside of the popup while they are visible, whereas non-modal

    68     %HbPopup provides properties that you can use to customize the following aspects of a popup:

    69     popups do not.

    69     

    70 

    70     - \b Modality. You can define whether the popup is modal or non-modal. A modal popup stops

    71     \sa HbDialog

    71       the user interacting with anything outside of the popup until it closes. A non-modal 

    72 */

    72       popup does not block the user's interaction with things outside of the popup. You 

    73 

    73       set and get the modality by calling setModal() and isModal(), respectively.  

    74 /*!

    74     

    75     \reimp

    75     - <b>Dismiss policy</b>. You can define which user actions, if any, cause the popup to 

    76       close. Possible values are defined by HbPopup::DismissPolicy. You set and get the dismiss 

    77       policy by calling setDismissPolicy() and dismissPolicy(), respectively.

    78     

    79     - <b>Background fade policy</b>. You can set a policy to fade everything behind the 

    80       popup. This is useful for modal dialogs, because the user cannot interact with 

    81       anything behind the popup. You control this policy by calling setBackgroundFaded() and 

    82       get the current policy by calling isBackgroundFaded().

    83     

    84     - \b Timeout. You can define a timeout that causes the popup to be dismissed automatically

    85       after a set a period. You set and get this property by calling setTimeout() and 

    86       timeout(), respectively. Call the setTimeout(HbPopup::DefaultTimeout) overload to use the 

    87       default value for the popup type, which provides a common look and feel.

    88       

    89     - <b>Frame background type</b>. You can define the popup's background style. However, 

    90       the actual appearance of the popup depends on the theme. You set and get this property by

    91       calling setFrameType() and frameType(), respectively.

    92       

    93     By default, popups are displayed in the center of the screen. Typically you should not override

    94     the default position of modal dialogs. However, some popups, such as context menus, need to be 

    95     in a specific position. For these, you can use the setPreferredPos() method to set the 

    96     preferred position.

    97     

    98     Popups that contain an editor may be repositioned by the virtual keyboard when it opens. 

    99     When the virtual keyboard closes, it attempts to reposition the popup back to its 

   100     previous position. However, this is not always possible, particularly when there has also

   101     been an orientation switch.

   102 

   103     \section _usecases_hbpopup Using the HbPopup class

   104     

   105     Although it is possible to create an instance of the HbPopup class, it is designed as a

   106     base class to provide common features to the many popup and dialog classes that are 

   107     derived from it (such as HbMenu, HbDialog, HbToolBarExtension, HbZoomSliderPopup). 

   108     

   109     How you open a popup depends on whether it is modal. It is important to use the 

   110     appropriate method, because this ensures the correct touch event handling.

   111     

   112     <table border="1" style="border-collapse: collapse; border: solid;">

   113     <tr><th>To open</TH><TH>Call</th></tr>

   114     <tr><td>Modal popups</td><td>open()</td></tr>

   115     <tr><td>Non-modal popups</td><td>\link QGraphicsItem::show() show()\endlink</td></tr>

   116     </table>

   117 

   118     \sa HbDialog, HbMenu

   119 */

   120 

   121 /*!

    82     This enum defines available default timeout values to be used in method

   128     Identifies default timeout values for various popup types. The timeout defines a time

    83     setTimeout(HbPopup::DefaultTimeout).

   129     period after which the popup is automatically closed. Using these default values 

   130     provides a consistent look and feel.

   131     \sa setTimeout(HbPopup::DefaultTimeout)

    88 

   136     Defines a permanent popup, for which no timeout is defined.

    89     No timeout is defined for automatically closing the popup. i.e. the popup is permanent.

    94 

   141     The default timeout value for confirmation notes.

    95     Timeout value intended to be used by confirmation notes.

   100 

   146     The default timeout value for standard non-permanent popups, such as notes.

   101     The default timeout value intended to be used by most non-permanent popups e.g. by notes.

   106 

   151     The default timeout value for context menus.

   107     The default timeout value intended to be used by context menus.

   113     This enum defines available dismiss policy values.

   157     Defines the available dismiss policy values. The dismiss policy defines which

   114 

   158     user actions cause the popup to close.

   115     The dismiss policy defines what user actions will cause the popup to be dismissed i.e. closed.

   159     

   160     \sa setDismissPolicy(), dismissPolicy()

   120 

   165     The popup cannot be closed by the user.

   121     The popup cannot be dismissed automatically by user interaction.

   126 

   170     Closes the popup when the user taps within the popup's bounding rectangle.

   127     The popup is dismissed when user taps within the bounding rectangle of the popup.

   133     The popup is dismissed when user taps outside of the bounding rectangle of the popup.

   176     Closes the popup when the user taps outside of the popup's bounding rectangle.

   138 

   181     Closes the popup when the user taps either inside or outside the popup's bounding 

   139     The popup is dismissed when user taps either within or outside

   182     rectangle.

   140     of the bounding rectangle of the popup.

   146     This enum defines available frame type values.

   188     Identifies the background graphical styles of the popup's frame.

   147 

   189 

   148     The frame types defines what frame item backgrounds will be used

   190     \sa setFrameType(), frameType()

   149     by the popup. Actual appearance is dependent on theme.

   154 

   195     Use the "strong" frame background style.

   155     The popup is using strong frame.

   160 

   200     Use the "weak" frame background style.

   161     The popup is using weak frame.

   167     This signal is emitted when the popup is about to be shown i.e. when method show() is called.

   206     This signal is emitted when the popup is about to be shown; that is, when 

   207     \link QGraphicsItem::show() show()\endlink is called.

   173     This signal is emitted when the popup is about to be hidden i.e. when method hide() is called.

   213     This signal is emitted when the popup is about to be hidden; that is, when 

   214     \link QGraphicsItem::hide() hide()\endlink is called.

   180     This signal is emitted when the popup is about to be closed i.e. when method close() is called

   221     This signal is emitted when the popup is about to close; that is, when 

   181     or the popup is

   222     \link QGraphicsWidget::close() close()\endlink is called or the popup is dismissed 

   182     dismissed by the user or timeout.

   223     by the user or timeout.

   187 

   228     Identifies the corners and edges of the popup for use when setting its position

   188     Placement is the corner or edge to which position of the popup refers to.

   229     using setPreferredPos(). 

   190 

   231   

   191 /*!

   232 /*!

   233     \var HbPopup::TopLeftCorner

   234     The popup's top left corner.

   235  */

   236   

   237 /*!

   238     \var HbPopup::TopRightCorner

   239     The popup's top right corner.

   240  */

   241    

   242 /*!

   243     \var HbPopup::BottomLeftCorner

   244     The popup's bottom left corner.

   245  */

   246    

   247 /*!

   248     \var HbPopup::BottomRightCorner

   249     The popup's bottom right corner.

   250  */

   251    

   252 /*!

   253     \var HbPopup::TopEdgeCenter

   254     The center of the popup's top edge.

   255  */

   256    

   257 /*!

   258     \var HbPopup::RightEdgeCenter

   259     The center of the popup's rightmost edge.

   260  */

   261     

   262 /*!

   263     \var HbPopup::BottomEdgeCenter

   264     The center of the popup's bottom edge.

   265  */

   266     

   267 /*!

   268     \var HbPopup::LeftEdgeCenter

   269     The center of the popup's leftmost edge.

   270  */

   271  

   272  /*!

   273     \var HbPopup::Center

   274     The center of the popup.

   275  */

   276 

   277 namespace {

   278     //initial values if not found from hbpopup.css

   279     static const int NO_TIMEOUT = 0;

   280     static const int CONFIRMATION_NOTE_TIMEOUT = 1500;

   281     static const int STANDARD_TIMEOUT = 3000;

   282     static const int CONTEXT_MENU_TIMEOUT = 6000;

   283 

   284     static const QLatin1String NO_TIMEOUT_STRING("no-timeout");

   285     static const QLatin1String CONFIRMATION_NOTE_TIMEOUT_STRING("confirmation-note-timeout");

   286     static const QLatin1String STANDARD_TIMEOUT_STRING("standard-timeout");

   287     static const QLatin1String CONTEXT_MENU_TIMEOUT_STRING("context-menu-timeout");

   288 }

   289 

   290 /*

   291    Currently, virtual keyboard must be able to position a popup

   292    containing an editor to an arbitrary place. VKB does its best to

   293    reposition the popup back to original position when needed. At least in

   294    orientation switch the old position naturally is wrong, hence popup

   295    must be relayouted.

   296 

   297    It would be unreasonable to make special checks for popup in vkb

   298    side. It also would be unreasonable to do special checks for vkb in

   299    popup side. Hence this semi-hidden dynamic property for

   300    communicating this special case.

   301 

   302    WARNING: Do not count on this special behaviour, we might remove it

   303    without prior notice. If you do require such a behavior, please

   304    raise a feature request and we might make this a proper API.

   305  */

   306 const char* KPositionManagedByVKB("PositionManagedByVKB");

   307 

   308 /*

   193     \primitive{background} HbFrameItem representing the popup background. The background can be weak or strong (different graphical styles) depending on popup type.

   310     \primitive{background} HbFrameItem representing the popup background. The background can be 

   311     weak or strong (different graphical styles) depending on popup type.

   288     timeout(HbPopupPrivate::timeoutValue(HbPopup::StandardTimeout)),

   397     timeout(-1),

   398     timeoutPending(true),

   399     pendingTimeout(HbPopup::StandardTimeout),

   296     mStartEffect(false),

   407     placement(HbPopup::TopLeftCorner),

   408     mStartEffect(true),

   319     q->setFocusPolicy(Qt::StrongFocus);    

   437     q->setFocusPolicy(Qt::StrongFocus);

   320     setBackgroundItem(HbStyle::P_Popup_background);

   438     q->setBackgroundItem(new HbFrameItem(QLatin1String("qtg_fr_popup"), HbFrameDrawer::NinePieces), -1);

   337     //itemFlags |= QGraphicsItem::ItemIsPanel;

   454     itemFlags |= QGraphicsItem::ItemIsPanel;

   338     q->setFlags(itemFlags);  

   455     q->setFlags(itemFlags);

   339 }

   456     q->setActive(false);

   457 

   458     q->setAcceptTouchEvents(true);

   459 

   460     defaultTimeouts[HbPopup::NoTimeout] = NO_TIMEOUT;

   461     defaultTimeouts[HbPopup::ConfirmationNoteTimeout] = CONFIRMATION_NOTE_TIMEOUT;

   462     defaultTimeouts[HbPopup::StandardTimeout] = STANDARD_TIMEOUT;

   463     defaultTimeouts[HbPopup::ContextMenuTimeout] = CONTEXT_MENU_TIMEOUT;

   464 }

   465 

   342 	Q_UNUSED(status);

   468     Q_UNUSED(status);

   469     Q_Q(HbPopup);

   470 

   471     showingInProgress = false;

   472     q->emit popupReady();

   473 }

   474 

   475 void HbPopupPrivate::_q_maskEffectDestroyed()

   476 {

   477     mVgMaskEffect = 0;

   347 	return HbInstancePrivate::d_ptr()->systemTone();

   482     return HbInstancePrivate::d_ptr()->systemTone();

   400         QEvent userEvent(QEvent::ContextMenu);

   535         QEvent userEvent(QEvent::LayoutRequest);

   406         HbEffect::start(q, "HB_POPUP", "orient_appear");

   547         HbEffect::start(q, "HB_POPUP", "orient_appear", q, "_q_appearEffectEnded",

   548                         QVariant(), extRect);

   484     if (dismissPolicy & HbPopup::TapOutside) {

   628     if (dismissPolicy & HbPopup::TapOutside && !modal) {

   599         if (!q->graphicsEffect()) {

   764         if (!mMaskedItem->graphicsEffect()) {

   600             // Attach the effect. Ownership is transferred to q.

   765             // Attach the effect. Ownership is transferred to the chain. The

   601             mVgMaskEffect->install(q);

   766             // ownership of the chain is transferred to q.  The chain is needed

   767             // because we must co-exist with FXML-based filter effects.

   768             HbVgChainedEffect *c = new HbVgChainedEffect;

   769             c->add(mVgMaskEffect);            

   770             c->install(mMaskedItem);

   603             // Avoid replacing already set effects. Do not mask if

   772             // Avoid replacing already set effects. Do not mask if this is not

   604             // this is not possible, otherwise we would unexpectedly

   773             // possible, otherwise we would unexpectedly delete the previously

   605             // delete the previously set graphics effect.

   774             // set graphics effect. However by being able to add the effect to a

   606             HbVgChainedEffect *c = qobject_cast<HbVgChainedEffect *>(q->graphicsEffect());

   775             // chain makes it possible to co-exist with FXML-based filter

   776             // effects. Similar solution is also present in HbEffectGroup.

   777             HbVgChainedEffect *c = qobject_cast<HbVgChainedEffect *>(mMaskedItem->graphicsEffect());

   613     }

   785         if (mVgMaskEffect) {

   614     QPixmap image(QSize(static_cast<int>(q->backgroundItem()->boundingRect().width()),

   786             // Make sure that mask effect is reset when destroyed

   615                         static_cast<int>(q->backgroundItem()->boundingRect().height())));

   787             QObject::connect(mVgMaskEffect, SIGNAL(destroyed()), q, SLOT(_q_maskEffectDestroyed()));

   788         }

   789     }

   790     /*if (!mPopupMask) {

   791         mPopupMask= new HbFrameItem();

   792         mPopupMask->frameDrawer().setFrameType(HbFrameDrawer::NinePieces);

   793         mPopupMask->frameDrawer().setFrameGraphicsName(QLatin1String("qtg_fr_popup_mask"));

   794     }

   795     mPopupMask->setGeometry(q->boundingRect());*/

   796 

   797     QPixmap image(q->backgroundItem()->boundingRect().size().toSize());

   621 #endif

   804 }

   622 }

   805 

   623 

   806 

   624 /*!

   807 

   625  Constructs a popup with given  \a parent graphics item.\n

   808 /*!

   626  Note: popups with \a parent set as 0 are behaving as real popups.

   809     Constructs a popup with the given \a parent graphics item. For true popup 

   627  This is actually the intended use.

   810     behavior (which means that it opens above other objects, at the highest z-order) 

   628 

   811     set \a parent to 0. This is the primary intended use of this class.

   629  However in some situation could be useful to embedd a popup into a QGraphicsItem.

   812 

   630  In this case a non zero \a parent value must be passed.

   813     However, it may sometimes be useful to embed a popup into a QGraphicsItem. To do 

   631  Popups with parent items behaving just like any other QGraphicsWidget.

   814     this, pass a non-zero \a parent value. HbPopup objects that have a parent are 

   632  The following features are not supported (i.e. ignored) for popup with parents:

   815     not real popups: they behave like any other QGraphicsWidget object and following

   633 

   816     properties are ignored. In addition the aboutToClose() signal is not emitted.

   634        - modality

   817     

   635        - timeout

   818     - \link isModal() modal\endlink property

   636        - unfadedItems

   819     - \link timeout() timeout\endlink  property

   637        - dismissPolicy

   820     - \link isBackgroundFaded() Backgroundfaded\endlink property

   638        - signal aboutToClose

   821     - \link  dismissPolicy() dismissPolicy\endlink property

   645     d->init();    

   828     d->init();

   657     d->init();    

   840     d->init();

   658 }

   841 }

   659 /*!

   842 /*!

   660  Destroys the popup.

   843     Destructor.

   691 

   871 /*!

   692 /*!

   872     Returns the popup's timeout property in milliseconds. The timeout causes the popup to

   693  Returns the popup timeout property in milliseconds.

   873     be dismissed automatically after the specified time period has elapsed. A value of

   694  If this property is not set the deafult is HbPopup::StandardTimeout.

   874     zero or less than zero, means that the popup is permanent and the user must take 

   695  \sa setTimeout()

   875     some explicit action in order to close the popup. 

   876     

   877     The default value for this property is HbPopup::StandardTimeout.

   878       

   879     \sa setTimeout(), setTimeout(HbPopup::DefaultTimeout)

   702 

   913 }

   703 /*!

   914 

   704  Sets the popup timeout property in milliseconds.

   915 /*!

   705  If timeout <= 0 then the popup is permanent and not closed automatically.

   916     Sets the popup's timeout property in milliseconds. A value of zero or less than zero

   706  \sa timeout() setTimeout(HbPopup::DefaultTimeout) QGraphicsWidget::close()

   917     means that the popup is permanent and is not closed automatically.

   918     

   919     \overload

   920     \sa timeout() setTimeout(HbPopup::DefaultTimeout), QGraphicsWidget::close()

   710     Q_D(HbPopup);

   924     Q_D(HbPopup);    

   712     //d->timeout = timeout;

   926 }

   713 }

   927 

   714 

   928 /*!

   715 /*!

   929     Sets the popup's timeout property to the default value for a standard popup type.

   716  It is a convenience overload of \a timeout() for setting HbPopup::DefaultTimeout values

   930     This has the advantage of creating a common look and feel.

   717  to achieve common look & feel.

   931 

   718  \sa enum DefaultTimeout

   932     \overload

   719  \sa timeout() setTimeout(int) QGraphicsWidget::close()

   933     \sa timeout(), setTimeout(int), QGraphicsWidget::close()

   723     setTimeout(HbPopupPrivate::timeoutValue(timeout));

   937     Q_D(HbPopup);

   724 }

   938     if (d->polished) {

   725 

   939         int newTimeout = d->defaultTimeouts.value(timeout);        

   726 /*!

   940         setTimeout(newTimeout);

   727  Returns the popup modality property.

   941     } else {

   728  A modal popup blocks any user initiated events outside of the popup

   942         d->timeoutPending = true;

   729  until it is closed.

   943         d->pendingTimeout = timeout;

   730  \sa setModal()

   944     }

   945 }

   946 

   947 /*!

   948     Returns the popup's modality property. A modal popup blocks any user-initiated

   949     events outside of the popup until it is closed.

   950     \sa setModal()

   739  Sets the popup modality property.

   959     Sets the popup's modality property.

   740  \sa isModal()

   960     

   741 */

   961     To open a modal popup, call open(). To open a non-modal popup, call 

   742 void HbPopup::setModal(bool enabled)

   962     \link QGraphicsItem::show() show()\endlink.

   743 {

   963     \sa isModal()

   744     Q_D(HbPopup);

   964 */

   745     d->modal = enabled;

   965 void HbPopup::setModal(bool modal)

   966 {

   967     Q_D(HbPopup);

   968     d->modal = modal;

   750  Sets the background of popup faded if \a fadeBackground is true otherwise

   973     Sets the popup's background fade policy property. When this is set to true, it causes

   751  the background will not be faded.

   974     everything behind the popup to be faded. 

   752  \sa isBackgroundFaded()

   975     \sa isBackgroundFaded()

   761  Returns if the background of the popup is faded or not.

   984     Returns the popup's background fade policy property. This controls whether 

   762  Default: true

   985     everything behind the popup is faded while the popup is on the screen. Typically

   763  \sa isBackgroundFaded()

   986     this property is set to true for modal dialogs only. The default is true.

   987     \sa setBackgroundFaded()

   772  Returns the dismiss policy of the popup.

   996     Returns the popup's dismiss policy. This defines which user actions (if any) cause 

   773  Default is HbPopup::TapOutside.

   997     the popup to close. The default is HbPopup::TapOutside.

   774  \sa setDismissPolicy()

   998     \sa setDismissPolicy()

   783  Sets the dismiss policy property for the the popup.

  1007     Sets the popup's dismiss policy property.

   784 

  1008 

   785  \sa dismissPolicy()

  1009     \sa dismissPolicy()

   794  Returns the frame type of the popup.

  1018     Returns the popup's frame type. This controls the popup's background style. However, 

   795  Default is HbPopup::Strong

  1019     the actual appearance depends on the theme. The default value is HbPopup::Strong.

   796  \sa setFrameType()

  1020     

  1021     \sa setFrameType()

   804 /*!

  1029 void HbPopupPrivate::doSetFrameType(HbPopup::FrameType newFrameType)

   805  Sets the frame typeproperty for the the popup.

  1030 {

   806 

  1031     Q_Q(HbPopup);

   807  \sa frameType()

  1032     switch( newFrameType ) {

  1033     case HbPopup::Weak:

  1034         q->setBackgroundItem(new HbFrameItem(QLatin1String("qtg_fr_popup_secondary"), HbFrameDrawer::NinePieces), -1);

  1035         break;

  1036     case HbPopup::Strong:

  1037     default:

  1038         q->setBackgroundItem(new HbFrameItem(QLatin1String("qtg_fr_popup"), HbFrameDrawer::NinePieces), -1);

  1039         break;

  1040     }

  1041 }

  1042 

  1043 /*!

  1044     Sets the popup's frame type, which controls the popup's background style.

  1045 

  1046     \sa frameType()

   827 

  1058 /*!

   828 /*!

  1059     Returns true if the popup is set to occupy the whole screen, false if not.

   829  Shows the popup as modal popup returning immediately.  

  1060 

   830 

  1061     \sa setFullScreen()

   831  Connects aboutToClose() signal to the slot specified by \a receiver and

  1062 */

   832  \a member. The signal will be disconnected from the slot when the

  1063 bool HbPopup::isFullScreen() const

   833  popup is closed.

  1064 {

   834 

  1065     Q_D(const HbPopup);

   835  For non modal popups, use show().  

  1066     return d->mFullScreen;

  1067 }

  1068 

  1069 /*!

  1070     Sets the popup to occupy the whole screen. When the popup is in full screen different

  1071     background graphics are used and there are no margins between popup and the main window.

  1072 

  1073     Inherited classes may have different color and graphics for full screen popups.

  1074 

  1075     \param enable A Boolean value; true for full screen popup, false for regular popup.

  1076 

  1077     \sa isFullScreen()

  1078 */

  1079 void HbPopup::setFullScreen(bool fullScreen)

  1080 {

  1081     Q_D(HbPopup);

  1082     d->setFullScreen(fullScreen);

  1083 }

  1084 

  1085 /*!

  1086     Displays the popup on the screen and returns immediately. This function also 

  1087     connects the popup's aboutToClose() signal to a specified slot. The signal 

  1088     is disconnected from the slot when the popup closes.

  1089     

  1090     Use this function to open modal popups. To open non-modal popups, call 

  1091     \link QGraphicsItem::show() show()\endlink.  

  1092 

  1093     \param receiver  The object that is to receive the signal.  

  1094     \param member  The slot on the receiver to which the signal is to connect. 

  1095     

  1096     \sa isModal() 

   850     \reimp

  1112     

   856     if (change == QGraphicsItem::ItemPositionChange) {

  1118     if (change == QGraphicsItem::ItemPositionChange) {        

  1119         // Skipping X-coordinate changes made by VKB since popupmanager handles popup to be in the

  1120         // center of the screen

  1121         if (property(KPositionManagedByVKB).isValid() && property(KPositionManagedByVKB).toBool() &&

  1122             !d->mAutoLayouting && value.isValid() && !value.toPointF().isNull()) {

  1123             QPointF newPointF(geometry().x(), value.toPointF().y());

  1124             d->mAutoLayouting = false;

  1125             return newPointF;

  1126         }

   861             if(d->hasEffects && boundingRect().isValid()) {

  1131             if (d->hasEffects && boundingRect().isValid() && d->polished) {

   871                 HbEffect::start(this, d->effectType, "appear", this, "_q_appearEffectEnded", QVariant(), extRect);

  1140                 HbEffectInternal::start(this, this, HbEffectInternal::UpdateAtEachStep,

   872 #endif//HB_EFFECTS

  1141                                         d->effectType, "appear", this, "_q_appearEffectEnded",

   873             } else {

  1142                                         QVariant(), extRect);

   874                 d->mStartEffect = true;

  1143                 d->showingInProgress = true;

  1144 #endif //HB_EFFECTS

   908                     if (!HbEffect::start(this, d->effectType, "disappear",

  1180                     if (!HbEffectInternal::start(this, this, HbEffectInternal::UpdateAtEachStep,

   909                                          this, "_q_delayedHide",

  1181                                                  d->effectType, "disappear",

   910                                          QVariant(), extRect)) {

  1182                                                  this, "_q_delayedHide",

  1183                                                  QVariant(), extRect)) {

   941  \deprecated HbPopup::handlePopupPos()

  1215     Reimplemented from QGraphicsItem.

   942          is deprecated. This function should not be used from the application side.

   943  Handles the popup position when Orientation changes

   944 */

   945 void HbPopup::handlePopupPos()

   946 {

   947     HB_DEPRECATED("HbPopup::handlePopupPos() is deprecated.");

   948     QEvent userEvent(QEvent::ContextMenu);

   949     QCoreApplication::sendEvent(this, &userEvent);    

   950 }

   951 

   952 /*!

   953     \reimp

   975     \reimp

  1237     Reimplemented from QGraphicsItem.

   979     QGraphicsItem::mouseReleaseEvent(event);        

  1241     Q_D(HbPopup);

  1242     d->handleBackgroundMouseReleaseEvent(event);

  1243 

  1244     QGraphicsItem::mouseReleaseEvent(event);

   981     // Note: Mouse release event is always handled in handleBackgroundMouseReleaseEvent

  1246 }

   982 }

  1247 

   983 

  1248 /*!

   984 /*!

  1249     Reimplemented from QGraphicsWidget. 

   985     \reimp

  1005         d->duplicateShowEvent = false;

  1269         d->duplicateShowEvent = false;        

  1270         //setting popup as active panel failed in previous showEvent

  1271         if (d->mActivePopup) {

  1272             setActive(true);

  1273         }

  1014         //setActive(true);

  1282         if (d->mActivePopup) {

  1283             setActive(true);

  1284         }

  1046     \reimp

  1315     Reimplemented from QGraphicsWidget. 

  1068 

  1334 }

  1069 }

  1335 

  1070 

  1336 /*!

  1071 /*!

  1337     Reimplemented from QGraphicsWidget. 

  1072     \reimp

  1085     \reimp

  1350     Reimplemented from QGraphicsWidget. 

  1114 

  1379 /*!

  1115 /* Currently, virtual keyboard must be able to position a popup

  1380     Reimplemented from QGraphicsWidget. 

  1116    containing a editor to an arbitrary place. VKB does it's best to

  1117    reposition popup back to original position when needed. At least in

  1118    orientation switch the old position naturally is wrong, hence popup

  1119    must be relayouted.

  1120 

  1121    It would be unreasonable to make special checks for popup in vkb

  1122    side. It also would be unreasonable to do special checks for vkb in

  1123    popup side. Hence this semi-hidden dynamic property for

  1124    communicating this special case.

  1125 

  1126    WARNING: Do not count on this special behaviour, we might remove it

  1127    without prior notice. If you do require such a behavior, please

  1128    raise a feature request and we might make this a proper API.

  1129  */

  1130 const char* KPositionManagedByVKB("PositionManagedByVKB");

  1131 

  1132 /*!

  1133     \reimp