Accessing -the toolbar from applications or application views

To access the current toolbar (CAknToolbar, defined in akntoolbar.h) -in applications, use the methods CAknAppUi::CurrentPopupToolbar() or CEikAppUiFactory::CurrentPopupToolbar() in the case -of a floating toolbar. For a fixed toolbar, use CAknAppUi::CurrentFixedToolbar() or CEikAppUiFactory::CurrentFixedToolbar(). The methods -return a pointer to either the application toolbar or a view-specific toolbar -(if defined).

To access the application toolbar directly from applications, -you can also call CAknAppUi::PopupToolbar() and CEikAppUiFactory::PopupToolbar(). To access the view-specific toolbar as a client, call CAknView::Toolbar(). These calls do not transfer -the ownership of the toolbar, so the framework takes care of the toolbar destruction.

The example below shows how to access the toolbar in the application -AppUi class. (You can also use CEikAppUiFactory methods.)

void CMyAppUi::DoSomethingToToolbar() - { - - // Current fixed toolbar (if view has no fixed toolbar, returns application toolbar) - CAknToolbar* fixedToolbar = CurrentFixedToolbar(); - - // Current popup toolbar (if view has no popup toolbar, returns application toolbar) - CAknToolbar* popupToolbar = CurrentPopupToolbar(); - - // Application toolbar - CAknToolbar* appToolbar = PopupToolbar(); - - … - - }

The example below shows how to access a view specific -toolbar in the application view class.

-void CMyView::DoSomethingToToolbar() - { - - // View toolbar - CAknToolbar* toolbar = Toolbar(); - - … - - } -

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

To access the current toolbar (CAknToolbar, defined in akntoolbar.h) +in applications, use the methods CAknAppUi::CurrentPopupToolbar() or CEikAppUiFactory::CurrentPopupToolbar() in the case +of a floating toolbar. For a fixed toolbar, use CAknAppUi::CurrentFixedToolbar() or CEikAppUiFactory::CurrentFixedToolbar(). The methods +return a pointer to either the application toolbar or a view-specific toolbar +(if defined).

To access the application toolbar directly from applications, +you can also call CAknAppUi::PopupToolbar() and CEikAppUiFactory::PopupToolbar(). To access the view-specific toolbar as a client, call CAknView::Toolbar(). These calls do not transfer +the ownership of the toolbar, so the framework takes care of the toolbar destruction.

The example below shows how to access the toolbar in the application +AppUi class. (You can also use CEikAppUiFactory methods.)

void CMyAppUi::DoSomethingToToolbar() + { + + // Current fixed toolbar (if view has no fixed toolbar, returns application toolbar) + CAknToolbar* fixedToolbar = CurrentFixedToolbar(); + + // Current popup toolbar (if view has no popup toolbar, returns application toolbar) + CAknToolbar* popupToolbar = CurrentPopupToolbar(); + + // Application toolbar + CAknToolbar* appToolbar = PopupToolbar(); + + … + + }

The example below shows how to access a view specific +toolbar in the application view class.

+void CMyView::DoSomethingToToolbar() + { + + // View toolbar + CAknToolbar* toolbar = Toolbar(); + + … + + } +

\ No newline at end of file