The ViewNavigator container
defines the ActionBar control.
The ActionBar control provides a standard area for a title, and
for navigation and action controls. It lets you define global controls
that users can access from anywhere in the application, or in a
specific view. For example, you can use the ActionBar control to
add a home button, a search button, or other options.
For a mobile application with a single section, meaning a single
ViewNavigator container, all views share the same action bar. For
a mobile application with multiple sections, meaning one with multiple
ViewNavigator containers, each section defines its own action bar.
Use the ActionBar control to define the action bar area. The
ActionBar control defines three distinct areas, as the following
A. Navigation area B. Title area C. Action
Areas of the ActionBar
components that let the user navigate the section. For example,
you can define a home button in the navigation area.
the navigationContent property to define the components
that appear in the navigation area. Use the navigationLayout property
to define the layout of the navigation area.
Contains either a String containing
title text, or components. If you specify components, you cannot
specify a title String.
Use the title property
to specify the String to appear in the title area. Use the titleContent property
to define the components that appear in the title area. Use the titleLayout property
to define the layout of the title area. If you specify a value for
the titleContent property, the ActionBar skin ignores
the title property.
Contains components that define
actions the user can take in a view. For example, you can define
a search or refresh button as part of the action area.
the actionContent property to define the components
that appear in the action area. Use the actionLayout property
to define the layout of the action area.
While Adobe recommends that you use the navigation, title, and
action areas as described, there are no restrictions on the components
you place in these areas.
Set ActionBar properties in the ViewNavigatorApplication, ViewNavigator, or View container
You can set the properties that define the contents of the ActionBar
control in the ViewNavigatorApplication
in the ViewNavigator container, or in individual View containers.
The View container has the highest priority, followed by the ViewNavigator,
then the ViewNavigatorApplication container. Therefore, the properties
that you set in the ViewNavigatorApplication container apply to the
entire application, but you can override them in the ViewNavigator
or View container.
Note: An ActionBar control is associated with
a ViewNavigator, so it is specific to a single section of a mobile
application. Therefore, you cannot configure an ActionBar from the
TabbedViewNavigatorApplication and TabbedViewNavigator containers.