Enabling
quick access to functions with a toolbar
To use the Toolbar API, follow the steps below.
-
Link the
AVKON
libraries
(
avkon.lib
,
eikcoctl.lib
) to the project
file of the application.
-
Define the toolbar in the
application resources. Set it as application or view specific.
-
Provide a class that implements
the toolbar observer (
MAknToolbarObserver
)
interface. Set the class as the observer of the toolbar (
CAknToolbar
)
created in the previous step.
-
If the toolbar items were
not defined in the resources, add them dynamically in the application code.
-
In the case of a floating
toolbar, set the toolbar visible. (The framework sets the fixed toolbar automatically
visible when activating the application/view.)
-
Handle toolbar events using
the observer interface methods.
Figure 1. Fixed toolbar with implementation classes
Implementing
a toolbar
To use a toolbar in your application, implement the following
use cases:
The
following use cases are optional, allowing you to set additional properties
for your toolbar:
Implementing
a toolbar extension (optional)
To use a toolbar extension in your
application, implement the following use cases:
The following use cases are optional, allowing you to set additional
properties for your toolbar extension:
Main implementation
files
The main implementation files for the Toolbar API are:
-
akntoolbar.h
for creating the toolbar and setting
its properties
-
akntoolbarobserver.h
for handling toolbar events
-
akntoolbarextension.h
for creating the toolbar extension
and setting its properties
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.