36 class HsVkbHost : public HbStaticVkbHost {

    38 class HsVkbHost : public HbStaticVkbHost

    39 {

    38 	explicit HsVkbHost(HbWidget *target):

    41     explicit HsVkbHost(HbWidget *target):

    39 		HbStaticVkbHost(target), mWidget(target) {}

    42         HbStaticVkbHost(target), mWidget(target) {}

    44 	void openFinished() {		

    47     void openFinished() {

    45 		updateViewHeight(applicationArea().height());

    48         updateViewHeight(applicationArea().height());

    46 	}

    49     }

    47 

    50 

    48 	void closeFinished(){				

    51     void closeFinished() {

    49 		updateViewHeight(-1);

    52         updateViewHeight(-1);

    50 	}

    53     }

    51 

    54 

    52 	void updateViewHeight(qreal height) {		

    55     void updateViewHeight(qreal height) {

    53 		HbView* view = mWidget->mainWindow()->currentView();

    56         HbView *view = mWidget->mainWindow()->currentView();

    54 		view->setMaximumHeight(height);

    57         view->setMaximumHeight(height);

    55 	}

    58     }

    59 	

    62 

    60 	HbWidget * mWidget;

    63     HbWidget *mWidget;

    74 /*!

    77 

    75   Sets view label visible or hidden.

    78 /*!

    76   \param visible When true label is set visible, invisible otherwise.

    79   Cleanup search text on showing search panel. Ensures vkb host instance

    77   \return \a true on success, \a false otherwise.

    80   is appears on show and disappears on hide search panel.

    78  */

    81   

    79 bool HsMenuViewBuilder::setLabelVisible(bool visible)

    82   \param visible When true search panel is to show up,

    80 {

    83   hide otherwise.

    81     bool result(true);

    84  */

    82 

    85 void HsMenuViewBuilder::searchPanelVisibilityChange(bool visible)

    83     if (visible != mViewOptions.testFlag(Label)) {

    86 {

    84         mViewOptions ^= ViewOptions(Label);

    87     if (visible) {

    85         result = parseSection(mSections[mViewOptions]);

    88         // TODO this is temprary solution, proper solution should come from Orbit

    86     }

    89         if (!HbVkbHost::getVkbHost(currentSearchPanel())) {

    87     return result;

    90             new HsVkbHost(currentSearchPanel());

    88 }

    89 

    90 

    91 /*!

    92   Sets search panel visible or hidden.

    93   \param visible When true search panel is set visible,

    94   invisible otherwise.

    95   \return \a true on success, \a false otherwise.

    96  */

    97 bool HsMenuViewBuilder::setSearchPanelVisible(bool visible)

    98 {

    99     bool result(true);

   100 

   101     if (visible != mViewOptions.testFlag(Search)) {

   102         mViewOptions ^= ViewOptions(Search);

   103         result = parseSection(mSections[mViewOptions]);

   104 

   105         if (visible) {

   106 			// TODO this is temprary solution, proper solution should come from Orbit

   107                         if (!HbVkbHost::getVkbHost(searchPanel()))

   108                                 {

   109                                 new HsVkbHost(searchPanel());

   110                                 }

   111             HbLineEdit *const lineEdit(searchPanelLineEdit());

   112 

   113             lineEdit->setText("");

   115         else {

    92         HbLineEdit *const lineEdit(searchPanelLineEdit());

   116            if (static_cast<HsVkbHost *>(HbVkbHost::getVkbHost(searchPanel()))) {

    93 

   117              static_cast<HsVkbHost *>(HbVkbHost::getVkbHost(searchPanel()))->

    94         lineEdit->setText("");

   118                      updateViewHeight(-1);

    95     } else {

   119             }

    96         if (static_cast<HsVkbHost *>(HbVkbHost::getVkbHost(currentSearchPanel()))) {

   120        }

    97             static_cast<HsVkbHost *>(HbVkbHost::getVkbHost(currentSearchPanel()))->

   121     }

    98             updateViewHeight(-1);

   122     return result;

    99         }

   123 }

   100     }

   124 

   101 

   125 /*!

   102 }

   126  \return \a true when label is visible, \a false otherwise.

   103 

   127  */

   104 /*!

   128 bool HsMenuViewBuilder::isLabelVisible() const

   105  \return pointer to the view resulting from last \a build call or NULL if 

   129 {

   106  the \a build has not yet been called.

   130     return mViewOptions.testFlag(Label);

   107  Memory ownership is not changed.

   131 }

   108  */

   132 

   109 HbView *HsMenuViewBuilder::currentView() const

   133 /*!

   110 {

   134  \return \a true when search panel is visible, \a false otherwise.

   111     const QString VIEW_NAME =

   135  */

   112         mViewContextToStringMap[mViewContext]

   136 bool HsMenuViewBuilder::isSearchPanelVisible() const

   113         + "View";

   137 {

   114 

   138     return mViewOptions.testFlag(Search);

   115     HbView *const view =

   139 }

   116         qobject_cast<HbView *>(mDocumentLoader.findWidget(VIEW_NAME));

   140 

   117 

   141 /*!

   118     if (view != NULL && mViewContext != HsInstalledAppsContext) {

   142  \return pointer to the main view.

   119         view->setToolBar(mToolBar);

   143  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   120     }

   144  Memory ownership is not changed.

   121 

   145  */

   122     return view;

   146 HbView *HsMenuViewBuilder::view() const

   123 }

   147 {

   124 

   148     return qobject_cast<HbView *>(mDocumentLoader.findWidget(VIEW_NAME));

   125 /*!

   149 }

   126  \return pointer to list view resulting from last \a build call or NULL if 

   150 

   127  the \a build has not yet been called.

   151 /*!

   128  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   152  \return pointer to the list item view.

   129  Memory ownership is not changed.

   153  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   130  */

   154  Memory ownership is not changed.

   131 HbListView *HsMenuViewBuilder::currentListView() const

   155  */

   132 {

   156 HbListView *HsMenuViewBuilder::listView() const

   133     const QString LIST_VIEW_NAME = mViewContextToStringMap[mViewContext]

   157 {

   134                                    + mOperationalContextToStringMap[mOperationalContext]

   135                                    + "ListView";

   136 

   163  \return pointer to the label.

   142  \return pointer to the view label resulting from last \a build call. It is 

   164  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   143  guaranteed to be not NULL if the \a build was called for the context

   165  Memory ownership is not changed.

   144  related to view including label.

   166  */

   145  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   167 HbGroupBox *HsMenuViewBuilder::label() const

   146  Memory ownership is not changed.

   168 {

   147  */

   148 HbGroupBox *HsMenuViewBuilder::currentViewLabel() const

   149 {

   150     const QString LABEL_NAME = mViewContextToStringMap[mViewContext]

   151                                + "Label";

   152 

   174  \return pointer to the searchPanel.

   158  \return pointer to search panel.

   175  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   159  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   176  Memory ownership is not changed.

   160  Memory ownership is not changed.

   177  */

   161  */

   178 HbSearchPanel *HsMenuViewBuilder::searchPanel() const

   162 HbSearchPanel *HsMenuViewBuilder::currentSearchPanel() const

   185  \return pointer to All Applications Action.

   169  \return pointer to All Applications Action. Guaranteed to be not NULL.

   196  \return pointer to All Collections Action.

   180  \return pointer to All Collections Action. Guaranteed to be not NULL.

   207  \return pointer to Search Action.

   191  \return pointer to Search Action. Guaranteed to be not NULL.

   218  \return pointer to Ovi Store Action.

   202  \return pointer to Ovi Store Action. Guaranteed to be not NULL.

   235     return qobject_cast<HbToolBar *>(

   230     return mToolBar;

   236                mDocumentLoader.findWidget(TOOL_BAR_NAME));

   231 }

   237 }

   232 

   233 /*!

   234  \return pointer to the toolbar extension.

   235  The pointer is valid until the HsMenuViewBuilder instance is destroyed.

   236  Memory ownership is not changed.

   237  */

   238 HbToolBarExtension *HsMenuViewBuilder::toolBarExtension() const

   239 {

   240     return mToolBarExtension;

   241 }

   242 

   243 /*!

   244  \return action group for \a allAppsState and \a allCollectionsState action.

   245  */

   246 QActionGroup *HsMenuViewBuilder::toolBarActionGroup() const

   247 {

   248     return mToolBarActionGroup;

   249 }

   250 

   251 /*!

   252  Reads docml configuration corresponding to current context.

   253  */

   254 bool HsMenuViewBuilder::build()

   255 {

   256     return readContextConfiguration(mViewContext, mOperationalContext);

   257 }

   258 

   259 

   251     VIEW_NAME("view"),

   273     OPERATOR_ACTION_NAME("operatorAction"),

   252     CONTAINER_NAME("container"),

   274     SEARCH_PANEL_NAME("searchPanel"),

   253     LIST_VIEW_NAME("listView"),

   255     SEARCH_PANEL_NAME("searchPanel"),

   276     mToolBar(new HbToolBar),

   256     LABEL_NAME("label"),

   277     mToolBarExtension(new HbToolBarExtension),

   257     LIST_VIEW_SECTION_NAME("list_view"),

   278     mViewContext(HsAllAppsContext),

   258     LIST_LABELED_VIEW_SECTION_NAME("list_labeled_view"),

   279     mOperationalContext(HsItemViewContext)

   259     LIST_SEARCH_VIEW_SECTION_NAME("list_search_view"),

   280 {

   260     LIST_SEARCH_LABELED_VIEW_SECTION_NAME("list_search_labeled_view")

   281     init();

   261 {

   262     buildSectionKeyMap();

   265     bool result = parseSection("") && parseSection(mSections[mViewOptions]);

   284     const bool result = parseSection(COMMON_SECTION_NAME);

   274  Deletes list view, search panel, view label, All Applications

   302  Deletes widgets owned by the Menu View Builder.

   275  Action, All Collections Action, Search Action, Ovi Store Action, container

   276  widget, main view toolbar and the main view.

   277 

   278  The destructor needs to be checked agains any change in related docml file.

   282     QObjectList objectList;

   306     delete mToolBarExtension;

   283 

   307     delete mToolBar;

   284     objectList << listView();

   308     qDeleteAll(mLoadedObjects);

   285 

   286     objectList << searchPanel();

   287 

   288     objectList << label();

   289 

   290     objectList << allAppsAction();

   291     objectList << allCollectionsAction();

   292     objectList << searchAction();

   293     objectList << mDocumentLoader.findWidget(CONTAINER_NAME);

   294     objectList << toolBar();

   295     objectList << view();

   296 

   297     foreach(QObject *obj, objectList) {

   298         obj->deleteLater();

   299     }

   314     QObjectList loadedObjects = mDocumentLoader.load(DOCUMENT_FILE_NAME,

   323     const QObjectList loadedObjects =

   315                                 sectionName,

   324         mDocumentLoader.load(DOCUMENT_FILE_NAME,

   316                                 &loadStatusOk);

   325                              sectionName,

   326                              &loadStatusOk);

   327 

   328     mLoadedObjects |= loadedObjects.toSet();

   326 /*!

   339 

   327  \retval Line edit of the searchPanel on success, 0 otherwise.

   340 /*!

   341  \return Line edit of the searchPanel on success, NULL otherwise.

   335     foreach(QGraphicsItem *obj, searchPanel()->childItems()) {

   349     foreach(QGraphicsItem *obj, currentSearchPanel()->childItems()) {

   356     Sets up mapping between ViewOptions and section names.

   370     Builds mapping between context and docml name buidling blocks.

   357  */

   371  */

   358 void HsMenuViewBuilder::buildSectionKeyMap()

   372 void HsMenuViewBuilder::init()

   359 {

   373 {

   360     mSections[ViewOptions()]  =

   374     mViewContextToStringMap[HsAllAppsContext] = "allApps";

   361         LIST_VIEW_SECTION_NAME;

   375     mViewContextToStringMap[HsAllCollectionsContext] = "allCollections";

   362 

   376     mViewContextToStringMap[HsInstalledAppsContext] = "installedApps";

   363     mSections[ViewOptions(Search)]   =

   377     mViewContextToStringMap[HsCollectionContext] = "collection";

   364         LIST_SEARCH_VIEW_SECTION_NAME;

   378     mOperationalContextToStringMap[HsItemViewContext] = "";

   365 

   379     mOperationalContextToStringMap[HsSearchContext] = "Search";

   366     mSections[ViewOptions(Label)]  =

   380 }

   367         LIST_LABELED_VIEW_SECTION_NAME;

   381 

   368 

   382 /*!

   369     mSections[ViewOptions(Label | Search)]   =

   383  Sets view context. Not reflected in widgets returned by the builder

   370         LIST_SEARCH_LABELED_VIEW_SECTION_NAME;

   384  until \a build is not run.

   371 }

   385  */

   386 void HsMenuViewBuilder::setViewContext(HsViewContext viewContext)

   387 {

   388     mViewContext = viewContext;

   389 }

   390 

   391 /*!

   392  Sets operational context. Not reflected in widgets returned by the builder

   393  until \a build is not run.

   394  */

   395 void HsMenuViewBuilder::setOperationalContext(

   396     HsOperationalContext operationalContext)

   397 {

   398 

   399     mOperationalContext = operationalContext;

   400 }

   401 

   402 /*!

   403  Reads configuration for requested context and ensures search panel and corresponding

   404  vkb host are managed properly.

   405  */

   406 bool HsMenuViewBuilder::readContextConfiguration(HsViewContext viewContext,

   407         HsOperationalContext operationalContext)

   408 {

   409     const QString sectionName = mViewContextToStringMap[viewContext]

   410         + mOperationalContextToStringMap[operationalContext] 

   411         + "ViewDefinition";

   412 

   413     const bool result = parseSection(sectionName);

   414 

   415     if (currentSearchPanel()) {

   416         searchPanelVisibilityChange(mOperationalContext == HsSearchContext);

   417     }

   418 

   419     return result;

   420 }

   421