Package io.jmix.ui.screen

Class Screen.BeforeCloseEvent

java.lang.Object

java.util.EventObject

io.jmix.ui.screen.Screen.BeforeCloseEvent

All Implemented Interfaces:

Serializable

Enclosing class:

Screen

public static class Screen.BeforeCloseEvent
extends EventObject

Event sent right before the screen is closed by its Screen.close(CloseAction) method. The screen is still displayed and fully functional.

In this event listener, you can check any conditions and prevent screen closing using the preventWindowClose() method of the event, for example:

     @Subscribe
     protected void onBeforeClose(BeforeCloseEvent event) {
         if (Strings.isNullOrEmpty(textField.getValue())) {
             notifications.create().withCaption("Input required").show();
             event.preventWindowClose();
         }
     }
 

See Also:

• Screen.addBeforeCloseListener(Consumer)
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected final CloseAction	closeAction
protected boolean	closePrevented
protected OperationResult	closeResult

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor	Description
BeforeCloseEvent(Screen source, CloseAction closeAction)

Method Summary

Modifier and Type	Method	Description
boolean	closedWith(StandardOutcome outcome)	Checks that screen was closed with the given outcome.
CloseAction	getCloseAction()
OperationResult	getCloseResult()
Screen	getSource()
boolean	isClosePrevented()
void	preventWindowClose()	Prevents closing of the screen.
void	preventWindowClose(OperationResult closeResult)	Prevents closing of the screen.

Methods inherited from class java.util.EventObject

toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

closeAction

protected final CloseAction closeAction

closePrevented

protected boolean closePrevented

closeResult

protected OperationResult closeResult

Constructor Details

BeforeCloseEvent

public BeforeCloseEvent(Screen source,
 CloseAction closeAction)

Method Details

getSource

public Screen getSource()

Overrides:

getSource in class EventObject

getCloseAction

public CloseAction getCloseAction()

Returns:

action passed to the Screen.close(CloseAction) method of the screen.

preventWindowClose

public void preventWindowClose()

Prevents closing of the screen.

preventWindowClose

public void preventWindowClose(OperationResult closeResult)

Prevents closing of the screen.

Parameters:

closeResult - result object returned from the Screen.close(CloseAction) method

getCloseResult

@Nullable
public OperationResult getCloseResult()

Returns:

result passed to the preventWindowClose(OperationResult) method

isClosePrevented

public boolean isClosePrevented()

Returns:

whether the closing was prevented by invoking preventWindowClose() method

closedWith

public boolean closedWith(StandardOutcome outcome)

Checks that screen was closed with the given outcome.