Menus

Cascades provides a number of menus you can use in your apps to allow your users to efficiently navigate your app. Menus let you hide certain options until they're needed. By using menus to organize the options, you can keep the main UI of your app neat and tidy. Be sure to check out the UI guidelines for best practices on working with menus.

Action menu

An action menu appears on the right side of an action bar. A user can tap the menu to display all the actions that are available for the current view of the app.


Screens showing a user tapping the menu to display the action menu.

To create an action menu, you specify that you want an action to appear on the action menu by using the ActionBar.placement property. This property accepts enumeration values from the ActionBarPlacement. Actions that use ActionBarPlacement::OnBar are added to the action bar until there's no more room for additional actions. When the action bar is full, any extra actions are added to the action menu. Actions that use ActionBarPlacement::InOverflow are placed in the action menu but aren't displayed on the action bar.

An action menu is a great place for actions that may not be used frequently, but are useful to your users. For more information on action menus, see Adding an action menu.

Context menu

A context menu is displayed when a user touches and holds a UI control in your app. This menu displays actions that are associated specifically with that control. Touching and holding a control displays a partial view of the context menu, and a user can then swipe the partial menu to display its full contents.


Screens showing an expanded context menu.

To implement an application menu, you use a property called Menu.definition and specify its value using a MenuDefinition object. This object contains the actions that you want to include in the application menu, all of which are included in the actions list property.

You can add a context menu to any Cascades component that extends the Control class. For more information on context menus, see Adding a context menu.

Application menu

An application menu allows you to place options that aren't directly tied to any particular screen in a hidden bar at the top of your app. Users can swipe down from the top of the screen to display important, but seldom used options.


Screens showing swiping down from the top of the screen to display the application menu.

The application menu is displayed when a user swipes down from the top of the screen. This menu supports the same types of actions as the action menu and context menu. Each action has properties such as title and image, and you can respond in any way you'd like when a user taps an action (for example, by displaying a new screen). The application menu is represented by the Menu class, and each action is an ActionItem object. As a best practice, you should add an application menu to the top-level control in your app. This approach makes sense because the application menu applies to your entire app instead of just a single screen or view. For more information on the application menu, see Adding an application menu.

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus