diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,94 @@ + + + + + +Enabling +quick access to functions with a toolbar +

To use the Toolbar API, follow the steps below.

+
    +
  1. Link the AVKON libraries +(avkon.lib, eikcoctl.lib) to the project +file of the application.
  2. +
  3. Define the toolbar in the +application resources. Set it as application or view specific.
  4. +
  5. 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.
  6. +
  7. If the toolbar items were +not defined in the resources, add them dynamically in the application code.
  8. +
  9. In the case of a floating +toolbar, set the toolbar visible. (The framework sets the fixed toolbar automatically +visible when activating the application/view.)
  10. +
  11. Handle toolbar events using +the observer interface methods.
  12. +
+ +Fixed toolbar with implementation classes + + +
Implementing +a toolbar

To use a toolbar in your application, implement the following +use cases:

    +
  • Constructing +the toolbar

  • +
  • Adding and removing +toolbar items (the toolbar buttons are defined in the Generic +button API)

  • +
  • Accessing the +toolbar from applications or application views

  • +
  • Accessing toolbar +items

  • +
  • Handling toolbar +item events

  • +

We need to provide more clarity +on the required order of implementing the use cases and clarify whether there +are alternative approaches for achieving the same results.

The +following use cases are optional, allowing you to set additional properties +for your toolbar:

    +
  • Controlling +toolbar visibility

  • +
  • Showing and +hiding toolbar items

  • +
  • Dynamic initialization +of the toolbar

  • +
  • Setting toolbar +properties

  • +
+
Implementing +a toolbar extension (optional)

To use a toolbar extension in your +application, implement the following use cases:

    +
  • Creating the +toolbar extension

  • +
  • Adding and removing +toolbar extension items

  • +
  • Accessing toolbar +extension items

  • +

The following use cases are optional, allowing you to set additional +properties for your toolbar extension:

    +
  • Showing or hiding +the toolbar extension

  • +
  • Dimming or hiding +toolbar extension items

  • +
+
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

  • +
+
+Toolbar API +description +Look and +feel guidelines for the toolbar +
\ No newline at end of file