View source for How to Add Options Menu in Symbian Application

{{Outdated|reason=The Symbian platform is no longer supported.}}
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}

[[Category:HowTo]]
[[Category:snippets]]

'''English''' [[How_to_Add_Options_Menu_in_Symbian_Application_Bulgarian|Български]]


= How to Add Options Menu in Symbian Application =

'''Options''' menu and '''Exit''' button can be attached to [http://doc.qt.nokia.com/latest/qmainwindow.html QMainWindow], [http://doc.qt.nokia.com/latest/qdialog.html QDialog] or to [http://doc.qt.nokia.com/latest/qwidget.html QWidget] on Symbian. QMainWindow has predefined Symbian CBA buttons but they have to be defined for QDialog and QWidget.

== Preconditions ==

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:

<code>
int main(int argc, char *argv[])
{
 QApplication app(argc, argv);

MainWindow mainWindow;
 mainWindow.showMaximized();

return app.exec();
}
</code>

== 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.

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

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 [http://doc.qt.nokia.com/latest/qmenu.html QMenu] should be added at the header:

</code> QMenu* m_pMenu; </code>

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

<code>
// 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);
</code>

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

= See also =

[http://developer.qt.nokia.com/wiki/Remove_actions_options_menu_in_Symbian Remove actions option menu in Symbian
]

= References =