QS60MainAppUi Class

The QS60MainAppUi class is a helper class for S60 migration. More...

Header: #include <QS60MainAppUi>
Since: Qt 4.6
Inherits:

Public Functions

QS60MainAppUi()
virtual ~QS60MainAppUi()
virtual void ConstructL()
virtual void DynInitMenuBarL(TInt resourceId, CEikMenuBar * menuBar)
virtual void DynInitMenuPaneL(TInt resourceId, CEikMenuPane * menuPane)
virtual void HandleCommandL(TInt command)
virtual void HandleResourceChangeL(TInt type)
virtual void HandleStatusPaneSizeChange()
virtual void RestoreMenuL(CCoeControl * menuWindow, TInt resourceId, TMenuType menuType)

Protected Functions

virtual void HandleWsEventL(const TWsEvent & wsEvent, CCoeControl * destination)

Detailed Description

The QS60MainAppUi class is a helper class for S60 migration.

Warning: This class is provided only to get access to S60 specific functionality in the application framework classes. It is not portable. We strongly recommend against using it in new applications.

The QS60MainAppUi provides a helper class for use in migrating from existing S60 based applications to Qt based applications. It is used in the exact same way as the CAknAppUi class from Symbian, but internally provides extensions used by Qt.

When modifying old S60 applications that rely on implementing functions in CAknAppUi, the class should be modified to inherit from this class instead of CAknAppUi. Then the application can choose to override only certain functions.

For more information on CAknAppUi, please see the S60 documentation.

Unlike other Qt classes, QS60MainAppUi behaves like an S60 class, and can throw Symbian leaves.

See also QS60MainDocument and QS60MainApplication.

Member Function Documentation

QS60MainAppUi::QS60MainAppUi()

Contructs an instance of QS60MainAppUi.

[virtual] QS60MainAppUi::~QS60MainAppUi()

Destroys the QS60MainAppUi.

[virtual] void QS60MainAppUi::ConstructL()

Second phase Symbian constructor.

Constructs all the elements of the class that can cause a leave to happen.

If you override this function, you should call the base class implementation as well.

[virtual] void QS60MainAppUi::DynInitMenuBarL(TInt resourceId, CEikMenuBar * menuBar)

Dynamically initializes a menu bar.

The resource associated with the menu is given in resourceId, and the actual menu bar is passed in menuBar.

If you override this function, you should call the base class implementation as well.

[virtual] void QS60MainAppUi::DynInitMenuPaneL(TInt resourceId, CEikMenuPane * menuPane)

Dynamically initializes a menu pane.

The resource associated with the menu is given in resourceId, and the actual menu pane is passed in menuPane.

If you override this function, you should call the base class implementation as well.

[virtual] void QS60MainAppUi::HandleCommandL(TInt command)

Handles commands produced by the S60 framework.

command holds the ID of the command to handle, and is S60 specific.

If you override this function, you should call the base class implementation if you do not handle the command.

[virtual] void QS60MainAppUi::HandleResourceChangeL(TInt type)

Handles a resource change in the S60 framework.

Resource changes include layout switches. type holds the type of resource change that occurred.

If you override this function, you should call the base class implementation if you do not handle the resource change.

[virtual] void QS60MainAppUi::HandleStatusPaneSizeChange()

Handles changes to the status pane size.

Called by the framework when the application status pane size is changed.

If you override this function, you should call the base class implementation if you do not handle the size change.

[virtual protected] void QS60MainAppUi::HandleWsEventL(const TWsEvent & wsEvent, CCoeControl * destination)

Handles raw window server events.

The event type and information is passed in wsEvent, while the receiving control is passed in destination.

If you override this function, you should call the base class implementation if you do not handle the event.

[virtual] void QS60MainAppUi::RestoreMenuL(CCoeControl * menuWindow, TInt resourceId, TMenuType menuType)

Restores a menu window.

The menu window to restore is given in menuWindow. The resource ID and type of menu is given in resourceId and menuType, respectively.

If you override this function, you should call the base class implementation as well.

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.