Building Mobile Enterprise Applications : webMethods Mobile Designer Native User Interface Reference : Native User Interface (NativeUI) Objects : nUINavView
nUINavView
com.softwareag.mobile.runtime.nui.nUINavView
Use to display the navigation view.
The navigation view has different formats based on the platform. For example, for some platforms the navigation view might display as a menu bar that is always visible and uses both icons and text. For other platforms, the navigation view might have hidden menu items that are displayed only when a user presses a button.
Usage Notes
*You can add nUINavbuttonElement objects to the nUINavView object.
Note:  
The nUINavbuttonElement object should not represent Back buttons. That is, the object’s Type attribute should not be set to nUINavbuttonElement.TYPE_BACK.
*The following are platform-specific considerations:
Android
*Software AG recommends limiting the number of buttons you add to a nUINavView object to six buttons. If you add more than six buttons, a more button displays on some Android devices.
*Android devices support two formats of the navigation view. Set the android.nativeui.navview.version property to control the format you want to use. You can set this property in the project’s _defaults_.xml file or in the handset-specific targets xml file. These files are located in the project’s targets directory.
*Set the property to 1 to use the older style pop-up menu that Android 2.3 and earlier used.
*Set the property to 2 to use the newer style menu introduced with Ice Cream Sandwich.
iOS
*Software AG recommends limiting the number of buttons you add to a nUINavView object on an iPhone in full-screen portrait mode to eight buttons.
Windows Phone
*Software AG recommends limiting the number of buttons you add to a nUINavView object to five buttons. If you add more than five buttons, five display and the remaining buttons are accessible through the pop-up menu as a list without icons.
Windows RT
Windows 8
*The navigation view displays as a pop-up menu that occupies the full width of the screen.
*Software AG recommends creating only one nUINavView object at a time.
*Software AG recommends limiting the number of buttons you add to a nUINavView object to six buttons.
Example
This code sample displays a navigation view. Illustrations of how the example code is rendered on various platforms follows the code sample.
protected nUIViewDisplay onCreateMainNavbarView()
{
//loadImage calls Image.createImage() with the appropriate path and file
extension.
navbar_view = new nUINavView(NUIID_NAV_VIEW);
navbar_view.setVscrollable(false);
navbar_view.setBgcolor (0);
navbar_view.add(new nUINavbuttonElement(-1, "Lorem",
loadImage ("ChartArea")));
navbar_view.add(new nUINavbuttonElement(-1, "Ipsum",
loadImage ("ChartPie")));
navbar_view.add(new nUINavbuttonElement(-1, "Dolor",
loadImage ("ChartBar")));
return navbar_view;
}
Platform
Platform-Specific Class and Illustration
Android -
Ice Cream Sandwich
Custom code to emulate a split Action Bar
Android -
2.3
android.view.Menu
iOS 7
UITabBar
iOS 6
UITabBar
Windows Phone -
compact
Microsoft.Phone.Shell.ApplicationBar
Windows Phone -
expanded
Microsoft.Phone.Shell.ApplicationBar
 
Windows RT
Windows 8
Windows.UI.Xaml.Controls.AppBar
 
Other
Copyright © 2007-2017 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback