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. +
  2. Define the toolbar in the +application resources. Set it as application or view specific.
    3. +
  3. 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.
    4. +
  4. If the toolbar items were +not defined in the resources, add them dynamically in the application code.
    5. +
  5. In the case of a floating +toolbar, set the toolbar visible. (The framework sets the fixed toolbar automatically +visible when activating the application/view.)
    6. +
  6. Handle toolbar events using +the observer interface methods.
    7. +
+ +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