SplitScreen

Class Overview

The SplitScreen class is a screen that manages the presentation of two side-by-side Screen. You use this class to implement a master-detail user interface for tablets devices, in which the left-side Screen presents a Screen and the right-side presents details of the selected item with another Screen.

Important: A SplitScreen should be the first Screen pushed by an Application.

The SplitScreen has no significant actions to do. Its job is to manager two side with two different screens. The master (left-side) screen could update the details (right-side) screen.

A typical implementation of SplitScreen could be:

 public class MySplitScreen extends SplitScreen {
 
 	public void onCreate() {
 		// list of items
 		setMasterScreen(MyListScreen.class);
 
 		// optional : the details screen could be blank
 		// here, we push a details screen for the first item from the master
 		// screen
 		setDetailsScreen(MyDetailsScreen.class, new ScreenParam().putInt("itemIndex", 0));
 	}
 
 }
 

Phone compatibility

If you use a SplitScreen on a phone, only the Master Screen is shown. When a Screen is pushed by the controller inside the Master Screen, then the Details Screen is pushed into the navigation Stack. The end-user could navigate between master and details thanks to navigation stack. To be sure having this behaviour, The main screen should prefer using pushScreen(Class) instead of other navigation stack actions.

Orientation changes behaviors

By default, both Screen are displayed in landscape orientation but only the detail view controller is displayed in portrait orientations. In portrait orientations, the master view controller can be displayed in a 'popup' way from a button.

Summary

[Expand] Inherited Constants
From class com.neomades.app.Screen int TITLE_BAR_STYLE_BLACK iOS TitleBar style black int TITLE_BAR_STYLE_DEFAULT iOS TitleBar style default
From interface com.neomades.app.Keys int KEY_BACK int KEY_CALL int KEY_CLEAR int KEY_DOWN int KEY_END int KEY_FIRE int KEY_LEFT int KEY_MENU int KEY_NUM0 int KEY_NUM1 int KEY_NUM2 int KEY_NUM3 int KEY_NUM4 int KEY_NUM5 int KEY_NUM6 int KEY_NUM7 int KEY_NUM8 int KEY_NUM9 int KEY_POUND int KEY_RIGHT int KEY_SOFT_LEFT int KEY_SOFT_RIGHT int KEY_STAR int KEY_UP
From interface com.neomades.app.Orientation int AUTO This is the default value, so that the current orientation is based on the device orientation settings. int LANDSCAPE Landscape orientation int PORTRAIT Portrait orientation int PORTRAIT_OR_LANDSCAPE Portrait or landscape orientation (this is equivalent to PORTRAIT | LANDSCAPE)
From interface com.neomades.ui.Alignment int BOTTOM Vertical bottom int HCENTER Horizontal center int LEFT Horizontal left int RIGHT Horizontal right int TOP Vertical top int VCENTER Vertical center or middle
From interface com.neomades.ui.StretchMode int MATCH_CONTENT The view will get the size of its content int MATCH_PARENT The view will fill the size of its parent

[Expand] Inherited Fields
From class com.neomades.app.Screen protected final Controller controller navigation controller

[Expand] Inherited Methods
From class com.neomades.app.Screen final void applyTitleBackgroundColorToStatusBar() Configure the color of the status bar to be the same as the title bar. View findView(int viewId) EventBus getApplicationEventBus() Gets the application's eventBus if exist. View getContent() Gets the content of this screen. final Controller getController() Gets the navigation Controller instance. Keyboard getKeyboard() Returns a Keyboard instance for the current Screen. final int getOrientation() Returns the current device orientation. ScreenParams getScreenParams() Return the parameters. final void hideTitleBarLeftMenuItem() Hide the default "Home" button item that appears in the left menu of the Title Bar of the first screen in the Android version of the application. void onContentError(ContentError error) Called when an error has been broadcasting to this screen. void onContentResponse(ContentResponse response) Called when a content response has been broadcasting to this screen. abstract void onCreate() This method has to be overridden to initialize the screen : creation and layout of UI elements, initializations, ... void onDestroy() This method can be overridden to provide a specific behavior when the screen is destroyed. void onKeyEvent(KeyEvent keyEvent) Called when a key is dispatched to a screen. void onMenuAction(MenuItem item) This method can be overridden to provide a specific behavior when a item of the Menu is chosen. void onMenuCreate(Menu menu) This method can be overridden to retrieve the menu corresponding to this screen. void onOrientationChanged(int orientation) Called when the screen orientation has changed. void onPause() This method can be overridden to provide a specific behavior when the screen is paused. void onReceiveEvent(Event event) Called when this screen has received an event (inside UI-Thread). void onResume() This method can be overridden to provide a specific behavior when the screen is resumed, after it has been paused. void onTouchEvent(TouchEvent touchEvent) Called when a touch is dispatched to a screen. void postQuery(Query query) Posts a query to a ContentManager. void registerContentError() Registers this screen to receive all ContentError event's type. void registerEvent(String type) Registers this screen to receive the given ContentResponse event's type. void registerEvents() This method is deprecated. Use registerContentError() instead. void send(Event event) Sends an event into Application's event bus. void setActivityIndicatorVisible(boolean visible) Shows or hides the activity indicator. final void setBackButtonText(String backButtonText) Replaces the "Back" button text for the current screen. final void setBackButtonTextColor(Color backButtonTextColor) Changes the "Back" button text color for the current screen. final void setBackground(Background background) Set the background for this screen. final void setBackgroundColor(Color color) Sets the background color of the screen. final void setBackgroundImage(int imageID) Set the background image for this screen. final void setBackgroundImage(Image image) Set the background image for this screen. void setContent(int layoutResId) Sets the content of this screen, with the root view of the layout. void setContent(View content) Sets the content of this screen, with the view passed in parameter. final void setFullscreenMode(boolean fullscreen) Hides title bar and bottom toolbar. final void setResult(ScreenParams result) Close the screen and send result to the ScreenResultListener. final void setSupportedOrientation(int orientation) Forces the screen to be in portrait and/or landscape mode. final void setTitle(int resId) Sets the title of the screen, which will be displayed at the top of the screen final void setTitle(String title) Sets the title of the screen, which will be displayed at the top of the screen. final void setTitleBackground(Background background) Sets the title bar background final void setTitleBackgroundColor(Color bgColor) Sets the title bar background color final void setTitleBackgroundImage(Image image) Sets the title bar background image final void setTitleBackgroundImage(int resImage) Sets the title bar background image final void setTitleBarStyle(int style) Sets the iOS title bar style final void setTitleBarTranslucent(boolean translucent) Sets the title bar translucent or not final void setTitleBarVisible(boolean visible) Set the navigation bar (iOS), action bar (Android) or title bar visible or not without animation. final void setTitleBarVisibleAnimated(boolean visible) Set the navigation bar (iOS), action bar (Android) or title bar visible or not with animation. final void setTitleColor(Color titleColor) Sets the title text color final void setTitleFont(Font font) Sets the title font void setTitleKeepNativeCase(boolean enabled) Enables or disables the title native case. final void setTitleView(View view) Replaces the title view (inside the title bar) with a custom View. void unregisterEvent(String type) Unregisters this screen to receive the given event's type. void unregisterEvents() Unregisters this screen to receive all event's type.
From class java.lang.Object boolean equals(Object obj) Indicates whether some other object is "equal to" this one. final Class<?> getClass() Returns the runtime class of an object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeout, int nanos) Causes current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed. final void wait(long timeout) Causes current thread to wait until either another thread invokes the notify() method or the notifyAll() method for this object, or a specified amount of time has elapsed. final void wait() Causes current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object.