How to Add Options Menu in Symbian Application

From Qt Wiki
Revision as of 12:21, 17 April 2015 by AutoSpider (talk | contribs) (Remove non-functioning "toc" command)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
IMPORTANT: The content of this page is outdated. Reason: The Symbian platform is no longer supported.
If you have checked or updated this page and found the content to be suitable, please remove this notice.

How to Add Options Menu in Symbian Application

Options menu and Exit button can be attached to QMainWindow, QDialog or to QWidget on Symbian. QMainWindow has predefined Symbian CBA buttons but they have to be defined for QDialog and QWidget.


Make sure that the status pane and the control pane of the application are enabled. To do it call method showMaximized() of the main window:

int main(int argc, char *argv[]) {

QApplication app(argc, argv);

MainWindow mainWindow;


return app.exec(); }

Defining menus in QMainWindow

QMainWindow has predefined Symbian CBA buttons so different options can be added to the Options menu by adding a new action.

menuBar()->addAction("Example", this, SLOT (exampleSlot()));

Please note that exampleSlot() slot is called when an item is selected from the Options menu and its behavior should be also implemented.

Defining menus in QDialog or QWidget

Symbian CBA buttons are not predefined for QDialog or QWidget and they have to be defined.

An instance of QMenu should be added at the header:

QMenu* m_pMenu;

At appropriate location should be added the implementation of Options menu and the Exit button:

// Create menu m_pMenu = new QMenu(this); m_pMenu->addAction("Example", this, SLOT (exampleSlot()));

// Create Options CBA QAction *pOptions = new QAction("Options", this); // Set defined menu into Options button pOptions->setMenu(m_pMenu); pOptions->setSoftKeyRole(QAction::PositiveSoftKey); addAction(pOptions);

// Create Exit CBA QAction *pExitButton = new QAction(QString("Exit"), this); pExitButton->setSoftKeyRole(QAction::NegativeSoftKey); // Exit button closes the application QObject::connect(pExitButton, SIGNAL (triggered()), QApplication::instance(), SLOT (quit())); addAction(pExitButton);

Of course the right button can be used not only to close the application as it can be connected to other slot.

See also

[ Remove actions option menu in Symbian ]