How to Add Options Menu in Symbian Application: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
(Remove non-functioning "toc" command)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''English''' [[How to Add Options Menu in Symbian Application Bulgarian|Български]]
{{Outdated|reason=The Symbian platform is no longer supported.}}
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}


=How to Add Options Menu in Symbian Application=
[[Category:HowTo]]
[[Category:snippets]]


'''Options''' menu and '''Exit''' button can be attached to [http://doc.qt.nokia.com/latest/qmainwindow.html QMainWindow] ''[doc.qt.nokia.com]'', [http://doc.qt.nokia.com/latest/qdialog.html QDialog] ''[doc.qt.nokia.com]'' or to [http://doc.qt.nokia.com/latest/qwidget.html QWidget] ''[doc.qt.nokia.com]'' on Symbian. QMainWindow has predefined Symbian <span class="caps">CBA</span> buttons but they have to be defined for QDialog and QWidget.
'''English''' [[How_to_Add_Options_Menu_in_Symbian_Application_Bulgarian|Български]]


==Preconditions==
 
= 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:
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:


==Defining menus in QMainWindow==
<code>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);


QMainWindow has predefined Symbian <span class="caps">CBA</span> buttons so different options can be added to the '''Options''' menu by adding a new action.
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.
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==
== Defining menus in QDialog or QWidget ==
Symbian CBA buttons are not predefined for QDialog or QWidget and they have to be defined.


Symbian <span class="caps">CBA</span> 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:


An instance of [http://doc.qt.nokia.com/latest/qmenu.html QMenu] ''[doc.qt.nokia.com]'' 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:
At appropriate location should be added the implementation of '''Options''' menu and the '''Exit''' button:


Of course the right button can be used '''not''' only to close the application as it can be connected to other slot.
<code>
// Create menu
m_pMenu = new QMenu(this);
m_pMenu->addAction("Example", this, SLOT (exampleSlot()));


=See also=
// 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);


[http://developer.qt.nokia.com/wiki/Remove_actions_options_menu_in_Symbian Remove actions option menu in Symbian] ''[developer.qt.nokia.com]''
// 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>


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


[http://wiki.forum.nokia.com/index.php/CS001351_-_Adding_Options_menu,_panes,_and_icon_to_a_Qt_for_Symbian_application Forum Nokia: Adding Options menu, panes and icon to a Qt for Symbian application] ''[wiki.forum.nokia.com]''
= See also =


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


* [[:Category:HowTo|HowTo]]
= References =
* [[:Category:snippets|snippets]]

Latest revision as of 12:21, 17 April 2015

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.
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

English Български


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.

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:

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

MainWindow mainWindow;
 mainWindow.showMaximized();

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())); <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:

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

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

References