diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita --- a/Symbian3/SDK/Source/GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-95CE2206-7AE0-48C0-97A7-4E2082F9F662.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,94 +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 + + + + + +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