com.haulmont.cuba.gui

Interface Screens

All Known Subinterfaces:

WindowManager

All Known Implementing Classes:

WebScreens

public interface Screens

Interface defining methods for creation and displaying of UI screens.

See Also:

ScreenBuilders

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Screens.LaunchMode Marker interface for screen launch modes.
static interface	Screens.OpenedScreens Provides information about opened screens, does not store state.
static interface	Screens.WindowStack Represents single tab / window stack in AppWorkArea.

Field Summary

Fields

Modifier and Type	Field and Description
static CloseAction	NAVIGATION_CLOSE_ACTION Constant that is passed to Screen.close(CloseAction) when the screen is closed by screens manager.
static java.lang.String	NAVIGATION_CLOSE_ACTION_ID

Method Summary

Modifier and Type	Method and Description
default <T extends Screen> T	create(java.lang.Class<T> screenClass) Creates a screen by its controller class.
default <T extends Screen> T	create(java.lang.Class<T> screenClass, Screens.LaunchMode launchMode) Creates a screen by its controller class.
<T extends Screen> T	create(java.lang.Class<T> screenClass, Screens.LaunchMode launchMode, ScreenOptions options) Creates a screen by its controller class.
default Screen	create(java.lang.String screenId, Screens.LaunchMode launchMode) Creates a screen by its screen id.
Screen	create(java.lang.String screenId, Screens.LaunchMode launchMode, ScreenOptions options) Creates a screen by its screen id.
Screens.OpenedScreens	getOpenedScreens()
boolean	hasUnsavedChanges() Check if there are screens that have unsaved changes.
void	remove(Screen screen) Removes screen from UI and releases all the resources of screen.
void	removeAll() Removes all child screens (screens of work area and dialog screens) from the root screen and releases their resources.
void	show(Screen screen) Displays the given screen according to its Screens.LaunchMode.
OperationResult	showFromNavigation(Screen screen) Displays the given screen taking into account already opened screens and multipleOpen option.

Field Detail

NAVIGATION_CLOSE_ACTION_ID

static final java.lang.String NAVIGATION_CLOSE_ACTION_ID

See Also:

Constant Field Values

NAVIGATION_CLOSE_ACTION

static final CloseAction NAVIGATION_CLOSE_ACTION

Constant that is passed to Screen.close(CloseAction) when the screen is closed by screens manager.

Method Detail

create

default <T extends Screen> T create(java.lang.Class<T> screenClass)

Creates a screen by its controller class.

By default, the screen will be opened in the current tab of the main window (OpenMode.THIS_TAB).

Parameters:

screenClass - screen controller class

create

default <T extends Screen> T create(java.lang.Class<T> screenClass,
                                    Screens.LaunchMode launchMode)

Creates a screen by its controller class.

Parameters:

screenClass - screen controller class

launchMode - how the screen should be opened

create

default Screen create(java.lang.String screenId,
                      Screens.LaunchMode launchMode)

Creates a screen by its screen id.

Parameters:

screenId - screen id

launchMode - how the screen should be opened

create

<T extends Screen> T create(java.lang.Class<T> screenClass,
                            Screens.LaunchMode launchMode,
                            ScreenOptions options)

Creates a screen by its controller class.

Parameters:

screenClass - screen controller class

launchMode - how the screen should be opened

options - screen parameters

create

Screen create(java.lang.String screenId,
              Screens.LaunchMode launchMode,
              ScreenOptions options)

Creates a screen by its screen id.

Parameters:

screenId - screen id

launchMode - how the screen should be opened

options - screen parameters

show

void show(Screen screen)

Displays the given screen according to its Screens.LaunchMode.

Parameters:

screen - screen

showFromNavigation

OperationResult showFromNavigation(Screen screen)

Displays the given screen taking into account already opened screens and multipleOpen option.

Parameters:

screen - screen

Returns:

operation result

remove

void remove(Screen screen)

Removes screen from UI and releases all the resources of screen.

Parameters:

screen - screen

removeAll

void removeAll()

Removes all child screens (screens of work area and dialog screens) from the root screen and releases their resources.

hasUnsavedChanges

boolean hasUnsavedChanges()

Check if there are screens that have unsaved changes.

Returns:

true if there are screens with unsaved changes

getOpenedScreens

Screens.OpenedScreens getOpenedScreens()

Returns:

object that provides information about opened screens